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CYCLE 3 HELPFUL HINTS 



This paper describes helpful hints on how to use Cycle 3 of 
NOS/VE. It Is intended to supplement* rather than to replace* 
the standard NQS/VE documentation* If you have any questions or 
suggestions* please see Tom McGee or Bonnie Swierzbin. Appendix 
D lists background documents and how to obtain thenu 

To obtain additional copies of this document while running on 
SN101 at Arden Hills* please type* 

SES*INT1.LISTHINTS C»<numbar of copies> 

To obtain a copy with revision bars against the Helpful Hints 
of the previous build (for Cycle 3* THIS IS NOT RECOMMENDED 
BECAUSE OF EXTENSIVE REFORMATTING), one can type! 

SES*INT1.LISTHINTS REVB C*<number of copies> 

The Z parameter is optional and defaults to one. 

Date Changes 

12/22/80 Revisions for NQS/VE Phase C 

2/12/81 Additional Revisions for NOS/VE Phase C 

6/09/81 Revisions for NOS/VE Build N 

6/19/81 Additional Revisions for NOS/VE Build N 

8/28/81 Revisions for NOS/VE Build 

11/06/81 Revisions for NOS/VE Bui Id P 

3/01/82 Revisions for NOS/VE Build 

4/15/82 Revisions for NQS/VE Cycle 2 

5/01/82 Revisions for NOS/VE Cycle 3 
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1.0 HAJQ£_maA£I££im£$-Q£-iai$-,aUILI3 



At Build Q the command names were updated per DAP ARH4776, In 
this and subsequent versions of this document only the new 
command names are used. (The system still supports the old 
names except DISPLAY. FILE which is the new name for the old 
DUMP.FILE,) 

The OS procedure has had a parameter changed* a parameter 
added* the way in which the validation job is run changed* and 
the names of certain files changed. 

The parameter that changed was INSTALL, It is now called KIND 
or K and «tay be given one of the following values: INSTALL or 
I (same as the old instai l«yes )* NORMAL or N (same as the old 
instai l*no)* and RECOVER or R (same as the old 
I nstal l*recover )* The default is RECOVER. 

The new parameter Is QUICK_V ALIOATE or QV which controls which 
users will be validated by the validation job. If this 
parameter is omitted the validation job will validate all 
users. If specified this parameter gives one or more user 
names to be validated in addition to the users INTl* INT2* 
DEVI* DEV2* REL1 and EVAL . 

The validation job is now created by the OS procedure (i.e. 
It is no longer on fi'le VALIDAT), Users that have their own 
versions of the validation job should now use the 
QUICK.VALIOATE parameter of the OS procedure. 

Prior to this tne "family user admi ni str ator M for family NVE 
was user JAN, This has been changed to user RKC since it is 
this user that maintains the validation file Information or 
the 170. Thus if on a call to DS» the VALIDATE_USER5 
parameter is given as NO (suppressing the running of the 
validation job) the only validated user will be RKC (not 
JAN), 

The format of the file defining which users to validate has 
been changed. Instead of directly calling the 

ADMINISTER_US£RS utility subcommands* a procedure local to the 
validation job is called. The name of the procedure is 
VALIDATE_USER and its parameters are a user name and all of 
the utility subcommands that specify a user's attributes* The 
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password defaults to the user name appended with 
procedure's parameter name for the RING.MIN 
RING.MINIMUM or RM. 



an X* The 
attribute Is 



The names of the files installed by the OS procedure have been 
changed* On the 180 the name changes are* 



SYSLI8 — > 

OSLIS — > 

SYSTEM.COMMANDS.LIBRARY — > 

OSLPI — > 

NQSVEPL — > 

CCM.RUN_TIME.LI BR ARY — > 

MATH.RUN TIME LI8RARY — > 

CY8IL.II " — > 

SCULIB — > 

scu.commands.library — > 

JEOIT — > 



OSFSSYSTEM.LIBRARY 

OSFSOPERATOR.LIBRARY 

aSFSCOMMAND.LIBRARY 

OS FSPROGR AM. INTER FACE. LIBRARY 

a$F$SOURCE_LIBRARY 

CCF$RUN.TIM£.LIBRARY 

MLF$RUN_TIME_LIBRARY 

CYF$CGMPIL£R 

SCF$QBJ£CT.LI8RARY 

SCFSCOMMAND.LIBRARY 

IFFSEDITOR 



On the 170 side the name changes are* 



osipi 


— > 


0SFPIL 


NOSVEPL 


— > 


0SFSL 


CCMLI8 


— > 


CCFRTL 


MATHLIB 


— > 


MLFRTL 


CY8ILII 


— > 


CYFIIC 


SCULIB 


— > 


SCFOL 


SCUCLI8 


— > 


SCFCL 


JEOIT 


— > 


IFFEDIT 


SYMDBG 


— > 


OBFDL 



These file name changes should not affect anyone except the 
maintainers of these flies and are mentioned here just for 
your information. 

Recovery of NOS/VE permanent files across deadstarts has been 
Implemented* This has brought about considerable change in 
the way NOS/VE is brought up. The NVE command has replaced 
UPMYVE and the new command* SETVE* provides a system procedure 
file for the NVE command* Enough details for the casual user 



are provided in Section 4.5. and a great deal 
provided in Section 5* 



of detai I is 



Permanent files 
created but may 
described In the 



need no longer be explicitly attached or 
be directly accessed on all commands as 
ERS. 



It seems that many people are running into a problem on the 
system concerning the use of M path w references to files* 
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Specifically, a job will "hang" If a CREATE. FILE (define) or 
ATTACH.FILE (attach) command for a file is followed by by 
another reference to the file using the "path" notation. For 
ex amp le * 

CREATE.FILE $USER.JUNK 



COPY.FILE SUSER.JUNK NEWJUNK 

wIM result In the Job begin hung. The reason is that there 
Is a LOCAL. FILE. NAME parameter on the create.fi le command 
which defaults to the name of the permanent file (in the 
examples JUNK); but the "implicit" access to the file via the 
copy.fi le command uses an internally generated local name for 
the file. Thus, the effect is the same as the following 
command sequence on NOSs 

DEFINE, JUNK. 

ATTACH,zunique«JUNK. 
COPY,zunique, NEWJUNK. 

Here, the job will hang on the attach command because of 
conflicting access to file JUNK. 

On NOS/VE* explicit use of the CREATE. FILE and ATTACH.FILE 
commands Is not generally necessary. For examples 

COPY.FILE .MY.FRIEND.SOME.FILE $USER.SOME.FILE 

wilt (Implicitly) attach file SOME.FILE from user MY. FRIEND'S 
vaster catalog, create file SOME. FILE in my master catalog and 
copy the former into the latter (if SOME.FILE already existed 
in my master catalog, it would be attached and overwritten). 

00 NOT MIX "IMPLICIT" ATTACH/CREATE WITH "EXPLICIT" 
ATTACH/CREATE. 

If you Insist on explicitly attaching or creating files then 
USE THE LOCAL FILE NAME that you assigned via the ATTACH.FILE 
or CREATE.FILE command. 

Sheldon Fewer is writing a DAP proposing to change the default 
for the LOCAL FILE NAME parameter on the CREATE.FILE and 
ATTACH.FILE commands. If sanity prevails, this DAP will be 
approved and the problem outlined above will be largely 
resolved. Until then PLEASE USE EITHER EXPLICIT ACCESS OR 
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1.0 MAJOR CHARACTERISTICS OF THIS 8UILD 

IMPLICIT ACCESS {preferably the latter) BUT NOT BOTH!!! 

o This build of the OS supports VI. 4 of the object text. All 
existing CYBIl binaries must be recompiled. Any assembler 
modules that have been converted to II text and saved on NOS 
must be reconverted* Any assembler modules that are sensitive 
to CYBIL f s heap allocation strategy must be rewritten. 

o VI. 4 object text also is source incompatible in one instance 
with prior versions! the value LLCSPVA for type 
LLT$ADDRESS_KIND has been renamed LLCSADDRESS and the value 
LLC$ONE_wORD_EXTERNAL_PROC is no longer supported. 

o An €01 problem exissts with respect to a file shared between 
jobs. An existing file is opened with an access mode of 
Append by job A. The same file is opened with an access mode 
of read by job B» Job A extends the file and either 
explicitly closes the file or terminates. Job 8 explicitly 
closes the file or terminates. In this case* since the job 
accessing the file in read mode terminated after the job which 
extended the file* EOI on the file will be reset to the 
original position and the result of the extend will be lost. 

o The long lines in OSLPI decks PMDCERR* PMDLQUE* PMDPRGX, 
PMDDBER* CYDRTEC* LLDLHOR* LLDCADR* and LLOPRGX have been 
shortened to 79 characters. 

o The NOS/VE Operator Facility has been implemented. It 
executes as part of the TAF control point and Is accessed 
through the K display. All commands must now be entered 
through this control point and not the NVE (formerly UPMYVE) 
control point. The Operator Facility is capable of displaying 
both a left and right screen area simultaneously* allowing the 
operator to view* for example* the system log and the CP 
display together. For further documentation of Operator 
Facility commands* see Section 4. 

o The Interstate Communication Facility* which Is described in 
Section 9 of the NOS/VE ERS - Program Interface (Rev. 8)* has 
been implemented. The callable subroutines described in 
section 9.3 reside In User Library LINKLI8 in the Integration 
catalogs INT1* D£V1* REL1* etc. NOS libraries SYSLIB and 
SRVLXB are also required to complete the loading process. 
LOSET loader commands must be used to select these libraries. 

o Interactive Usage Restrictions! 

- When logging in to NOS/VE (i.e. HELL0*TAF etc.) do not 
enter a terminate break (CTRL t) or a pause break (CTRL p) 
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before the 'welcome message 1 appears at the terminal* A 

pause or terminate break entered before the Interactive 

N3S/VE job has completed lt f s Initialization may crash the 
system. 

A REQUEST_TERMINAL command in a batch job will crash the 
system* This can happen accidently through a 

REQUEST.TERMINAL command in a user prolog when the user 
runs a batch job since the prolog is executed for both 
interactive and batch jobs* The problem can be avoided by 
making the rEQUEST.TERM INAL command in the prolog 
conditional on the job type as follows' 

IF $JQB(M0DE) <> »8ATCH» THEN 

RE QUEST. TERMINAL 
IFEND 

o Any product or utility that is placed in the $SYSTEli catalog 
(or any frequently loaded program) should be bound using the 
CREATE_MQDUL£ subcommand of the CREATE_08JECT_LIBRARY 

utility* This wilt minimize overhead associated with loading 
the product or utility* 

o Debug responds to terminal breaks when a program is being 
debugged* Howeyer* entering a pause or terminate break when 
debug Is active (i*e* the 08/ prompt has appeared and the 
user has not issued the RUN command) will cause the task to 
term! nate. 

When sharing executable files via permanent files (i*e* 
compilers* libraries* etc.) you should make the file an 
object library via the CRE ATE_08JECT_LIBRARY utility. By 
sharing object libraries instead of object files* the code is 
actually shared among all tasks using the library; the library 
is not copied to another segment but is executed directly* 

1 • 1 &aU££-USA££_£&ilI£JL£& 



1*1.1 EXECUTING PROGRAMS 



PROCESS 

Create an object text file by compiling a program on NOS 
Then perform the following steps on NOS/VE* 
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1.0 MAJOR CHARACTERISTICS OF THIS BUILD 
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- Acquire any necessary libraries (which are ao.£ quoted In text 
embedded directives) by eitheri 

o Attaching them from the system catalog* either explicitly 
or via prolog 

or 
o Creating the library file via the object library generator 

or 
o Staging the library file from NOS to NOS/VE using the 
GET.OBJECT.LIBRARY command. 

- Get the file from NOS and convert the object text file frorr 
the CI data mapping to II data mapping by executing the 
CONVERT. OBJECT.FILE command. 

- Load and execute the program via the EXECUTE.TASK command* 
specifying the nee libraries with the LIBRARY parameter! 
alternatively SET.PROGRAM. ATTRIBUTES may be used to include 
the libraries in all subsequent EXECUTE.TASK commands. 

- Stage the loadmap from NOS/VE to NOS for printing by using 
ei then 

o The REPLACE. FILE command with A6 conversion mode specified 
If running on the simulator. 

or 
o The PRINT command if running on the hardware. 

EXAMPLES 

The following Is an example command sequence for executing a 
program not requiring any libraries for loading! 

Assumptions) all modules to be loaded are contained on the NOS 
permanent file •citxtrs 1 . 

C0NVERT.Q8JECT.FILE CITXTRS 

EXECUTE. TASK CITXTRS PARAMETER- 'progr am parameters 1 

PRINT LOADMAP 

The following is an example command sequence for executing a 
program requiring libraries for loadlngi 

Assumptions! the NOS permanent file •citxtrs 1 contains object 
text generated by the CYBIL CI compiler* The compiler modules 
reference procedures contained on the library •myllb 1 and the 
CYBIL run-time library. These libraries have been generated on 
NOS/VE and saved on NOS. 
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GET. OBJECT. LIBRARY MYLIB 

SET.PROGRAM. ATTRIBUTES LOAD.MAP.QPTIONS* C BLOCK >£NTRY_POINT,SEGME NT 

C0NVERT_0BJECT_FILE CITXTRS 

EXECUTE.TASK CITXTRS 'program parameters* LIBRARY«MYLIB 

PRINT.FILE LOADMAP 

1.1.2 CREATE OBJECT LIBRARY ON NQS/VE AND SAVE IT ON NOS 

Mates! 

o CLG0170 Is NOS Permanent file name for file containing CI 
object text for modules to be included in the library. 

o IITEXT180 Is NOS/VE local file name for fife containing II 
object text for modules to be included in the library* 

o LIBRARY180 is NOS/VE local file name for the library being 
created. 

o ILIB170 is NOS permanent file name for file containing the 
I ibrary. 

NOS/VE Job Commands 

CaNVERTJ38JECT_FILE IITEXT180 CLG0170 

CREATE.OBJECT.LIBRARY 

ADD.NODULE LIBRARY»IITEXT190 

GENERATE.LIBRARY L I8RARY-LI8RARY180 

QUIT 

REPLACE.FILE LI8RARY180 ILIB170 0C»B56 

1.1.3 MODIFY A PREVIOUSLY SAVED OBJECT LIBRARY 

o ILIB170 Is NOS permanent file name for file containing the old 
I ibrary 

o LIBRARY180 is NOS/VE local file name for file containing the 
old I Ibrary 

o CM0D170 Is NOS permanent file name for file containing CI 
object text for the new module 

o NEWIIMODULE is NOS/VE local file name for file containing II 
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object text for the new module 

o NEyLIBRARY Is NOS/VE local file name for the library being 
created 

o NLIB170 is NQS local file name for new library 

NQS/VE Job Commands 

GET.OBJECT. LIBRARY LIBRARY180 ILIB170 

CONVERT.OBJECT.FILE NEWIIMODULE CMOD170 

CR£ATE_Q8JECT_LIBRARY 

ADD_MQDUL£ LIBRARY-LIBRARY180 

REPLACE_MODULE LIBRARY»NEWI IMOOULE 

GENERATED I BRARY L IBRAR Y«NEWLI8RARY 

QUIT 

REPLACE^FILE NEWLI8RARY NLIB170 0C«B56 

1.1.4 ROUTE AN INPUT FILE FROM NOS TO NOS/VE 

Running from an interactive terminal* enter* 

GET* f I lename. 

R0UTE.fi lename#DC*LP#FC«RH. 

The input file which is sent to NOS/VE must be in 6/12 ASCII 
Cor display code subset). The job file must be a single 
partition NOS record containing NOS/VE commands. The first 
statement must be a valid LOGIN command with user* password and 
family name specified* Multi partition input files are not 
supported by NOS/VE so NOS data files used by the program must be 
obtained through the GET_FILE command. 



1.1.5 PRINT A NOS/VE FILE 



At NOS/VE job termination the job log will be automatically 
returned to NOS. The job log will be appended to the NOS/VE 
output file OUTPUT. NQS/VE print files must be written by SAM as 
8/8 ASCII RT«V. Print files will be converted from 8/8 ASCII 
RT«V to NQS 8/12 ASCII when they are sent to NOS and will be 
printed In upper/lower case. 

All NOS/VE output files will appear In the NOS output queue 
(NOS H#0 display) with the name IRHFxxx as a banner. In order to 
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print a NOS/VE file* the following command must be Issued within 
your job or be entered from the system console via the operator 
facl lityt 

PRXNT.FILE filename 
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2.0 C0HttAliI2-IMI£ftEA££-SIAIUS 



2.1 A££E£i-Ifl-MSm-I!i-DJLIAL..£lAlE 



2.1.1 LOGIN TO NOS/VE 



To initially login to NOS/VE via TAF* you must cause the first 
login attempt to fail. This can be done by responding to the 
"FAMILY!* login prompt with something likei H *** w . This must be 
done because the system will try to connect the terminal to IAF 
on the first login attempt no matter what is typed* To access 
TAF do the following on the second w FAMILYi H prompts 

* us er * p as swor d* TAF 

You can access TAF from IAF by doing w HELL0*TAF w or by 
answering TAF to the system prompt "APPL ICATION***. 

2.1.2 TERMINAL USAGE 



1) The slant </) is the prompt to enter a NOS/VE command. Any 
normal NOS/VE command can now be entered (continuation 
lines are prompted with ../)• The full ASCII character 
set* lower or upper case and all special characters* can be 
used. 

2) A LOGOUT command will cause the NOS/VE Interactive Job to 
terminate. A new NOS/VE Interactive Job can then be 
started by responding to the • APPLICATION* • prompt with 
TAF. 

3) Terminal breaks (control-t and control-p) can be used to 
terminate a task or command and suspend a task and enter a 
new task to process SCL commands. Control-t causes a 
terminate break and control-P causes a pause break. 
Terminate break will terminate a command or the most 
recently executed task. A pause break will suspend 
execution and allow commands to be entered. When a 
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terminal is in pause break state* two additional commands 
are aval I abl e* 

RESUME_CQMMAND - resume execution at the point of 
interruption. 

TERMINATE.CQMMAND - cause a terminate break condition as 
a terminate break had been entered. 

Both terminate break and pause break are available to programs 
as conditions via the program management condition mechanism. 

2.1.3 NOS/VE PROGRAM ACCESS TO THE TERMINAL 

1) Interactive NQS/VE jobs are able to obtain terminal input 
through the AHPiGET.NEXT or AMP$GET_PARTIAL pro grans 
interface which can be used by both task services and user 
ring programs. Interactive programs which use this 

interface should be able to handle both upper and lower 
case input in order to make them more convenient to use in 
both 64 and 96 character set modes. 

2.2 £QfiaAaa-4Ua-£A£AB£I£E-&&H££ 

During the next few months a command supported by the system 
may not be in sync with your command interface document. The 
parameter descriptor table gives an accurate* concise description 
of the command interface as currently supported. 

The definition of a command's parameter list is enclosed in 
parenthesis with a parameter description per line. Each 
description has the general form* 

PARAMETER NAME* ALLOWED PARAMETER VALUES » PARAMETER DEFAULT 
VALUE 

Parameter Names - describes the parameter name and any 
abbr eviations. 

ALLQWEO PARAMETER VALUES - describes the kind of value allowed 
and whether a list of values is possible. The value kind can be 
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2.0 COMMAND INTERFACE STATUS 
2.2 COMMAND AND PARAMETER NAMES 



further qualified. In some cases* the actual values allowed are 
described using the KEY notation. The value kinds include 
INTEGER, STRING* NAME, FILE* STATUS. 

PARAMETER DEFAULT VALUES - describes the defaulting rules 
and/or values for the parameter. $R£QUIRED and SOPTIONAL are 
obvious. Other values in this position will be treated as if 
they were entered by the user on command invocation. 



See the 
detal Is. 



PROC command in the Command Interface ERS for more 



The PDTs for the commands currently in the system can 
displayed using the DISPLAY_COMMAND_INFQRMATION command. This 
documented In the nonstandard command section of this document 



be 
i s 



2.3 £Q!l£iAlia-Blti£I10!i2 



Eiiaciian 

SMOD 

SCHAR 

SCLOCK 

$DATE 

$FILE 

SFNAME 

SINTEGER 

SNAME 

$0RD 

SREAL 

SSTRING 

SSTRLEN 

SSTRREP 

SSUBSTR 

SUNIQUE 

STIME 

$VAR 

SSPECIFIED 

SSST.COUNT 

$VALUE_COUNT 

SRANGE 

$PARAMETER_LIST 

SPARAMETER 

SSTATUS 

SCONDITION 

SSEVERITY 

$PR0CESS0R 



Status 

unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
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2.0 command interface status 
2.3 command functions 



$J08 
SPROGRAM 



unchanged 
unchanged 



2.4 SXSIfiL.ACC£SS-Ca!UlAlUlS 



C.&imaQ*U 

SET.LINK_ATTRIBUT£S 

LOGIN 

LOGOUT 

SET.PASSWORD 



unchanged 
unchanged 
unchanged 
unchanged 



- *1 



*1 The family name cf the job doing the submit will be used as 
the default family name on batch jobs. The default for jobs 
submitted from NOS will be family $SYSTEM« This effectively 
means that whenever NOS/VE Jobs are submitted from NOS the 
family parameter is required. 



2.5 ££SQy&££„J3AM££H£Jtt 



REQUEST_TERMINAL 



unchanged 



2.6 EIlE_84ii&&£jj£ttI 



SET.FILE.ATTRIBUTES 

C0PYJ=ILE 

OISPLAY^FILE 

COMPARE.FILE 

DI$PLAY_FILE_ATTRIBUTES 

SKIP.TAPE 



unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 



2 . 7 E££aAa£M-EILEJBAflAG£i3£NI 

££JBi£Qd 

GET_FILE 
REPLACE.FILE 
CREATE. FILE 



Siaius 

unchanged 
unchanged 
unchanged 
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2.0 COMMAND INTERFACE STATUS 
2.7 PERMANENT FILE MANAGEMENT 



ATTACH.FILE 
DELSTE.FILE 
CHANGE.CATALOG.ENTRY 
CREATE.FILE.PERMIT 
DELETE. FILE PERMIT 
CREATE. CATALOG 
DELETE.CATALQG 
DELETE.CATALQG PERMIT 
CREATE. PERMIT.CATALOG 
DISPLAY.CATALOG 
DISPLAY.CATALOG ENTRY 
SET.WORKING CATALOG 



unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 



2 * 8 i£JL_SI AI£fl£MIS-Alifl-£fiD££flU&£S 

PRQC/PRQCEND 

SET.COMMAND.LIST 

DISPLAY.COMMAND LIST 

REPEAT/UNTIL 

UHILE/WHILENO 

CREATE.VARIABLE 

DELETE. VARIABLE 

BLOCK/ BLOCKEND 

LOOP/LOOPEND 

FQR/FOREND 

IF/ELSEIF/ELSE/IFEND 

CYCLE 

EXIT 

tfHEN/WHENEND 

CONTINUE 

CANCEL 

INCLUDE.FILE 

COLLECT.TEXT 

DISPLAY.VALUE 

EXIT.PROC 

ACCEPT. LINE 

INCLUDE.LINE 

CREATE. FILE CONNECTION 

DELETE. FILE.CONNECTION 

DISPLAY.FILE.CONNECTION 

change HCS var lable 

display HCS vari abl e 



unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
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2.0 COMMAND INTERFACE STATUS 
2.9 INTERACTIVE COMMANDS 



2.9 IliX££4dI££-£OJlilA&&£ 



Cfljnaand 

RESUME.COMMAND 
TERMINATE.COMMANO 
SET_TERMINAL ATTRIBUTES 
DISPLAY_T£RNINAL ATTRIBUTES 



unchanged 
unchanged 
unchanged 
unchanged 



2*10 QliI£I-£Qfi£-aAIBI£M!ia£ 

£0.131 3D J 

CREATE.08JECT.LI8RARY 

DISPLAY.NEW.LIBRARY 

SELECT_DISPLAY_OPTION 

ADD. MODULE 

REPLACE.MODULE 

COMBINE.MODULE 

CREATE_MODULE 

3IND MODUtE 

CREATE.PRQGRAM DESCRIPTION 

DELETE. MODULE 

CHANGE. MODULE ATTRIBUTE 

SATISFY.EXTERNAL REFERENCES 

REORDER.MODULE 

GENERATE.LIBRARY 

DISPLAY_0BJECTJ.I8RARY 

COMPARE.OBJECT LIBRARY 

QUIT 

CI to II Conversion 



iijiiis 



unch 
unch 
unch 
unch 
unch 
unch 
unch 
unch 
unch 
unch 
unch 
unch 
unch 
unch 
unch 
unch 
unch 
unch 



anged 
anged 
anged 
anged 
anged 
anged 
anged 
anged 
anged 
anged 
anged 
anged 
anged 
anged 
anged 
anged 
anged 
anged 



2.11 Utt&-ttm££S 

Cflflmaad 

DISPLAY.LOG 
DISPLAY.MESSAGE 



S±J±il$ 

unchanged 
unchanged 



2.12 EILE-SiaUILtifi 
Canaad 

HCS JMROUTE 



itJtilS 



r erooved 
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2.0 COMMAND INTERFACE STATUS 
2.13 PROGRAM EXECUTION 



2.13 £&aaUI3JE*££UIIQa 

Camniaai Sialic 

SET.PR0GRAM.ATTRI8UTES new - *3 

DISPLAY.PROGRAM unchanged 

EXECUTE unchanged 

"name call* unchanged - *1 

TASK/TASKENO unchanged 

TERMINATE.TASK unchanged 

WAIT unchanged 

SET.DEBUG.RING unchanged 

DISPLAY.ACTIVE.TASKS new - *2 

*1 Warning - "name cal l w works only for SCL procedures unless a 
FILE command has been Issued to specify that the 
FILS.CONTENTS are OBJECT and the F REORGANIZATION is DATA or 
LIBRARY. The FILE command must be reissued every time the 
file Is brought oyer from NOS. The CQNVERT.08JECT.FILE> 
GET.OBJECT.FILE* and GET.Q3J ECT.L I8RARY nonstandard commands 
Issue the appropriate SET.FILE. ATTRIBUTES command and are 
therefore recommended. 

*2 Replace HCS TSTATUS command. 

*3 Replaces SET.OBJECT.LIST and SET.P ROGRAM.OPTIONS commands. 

2.14 lXm_8A£U££&£UI 

SUBMIT. JOB unchanged 

DISPLAY.JOB.STATUS unchanged 

TERMINATE.JQB unchanged 

PRINT.FILE unchanged 

TERMINATE.PRINT unchanged 

DISPUY.PRINT.STATUS unchanged 

2 . 15 tll3SiJr£*£ailMAliaS-ia£L£!l£!iI£^Ai-££0£S 

In this build* several NOS/VE commands have been implemented 
as SCL procedures in order to make the system look more like the 
final version. Users are urged to use these procedures rather 
than their interim counterparts since the interim commands will 
ultimately be withdrawn. 
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2.0 COMMAND INTERFACE STATUS 

2*15 NgS/V| w COMfJANOS w IMPLEMENT|D^AS^PROCS 

These procedures nil I be made available via the default system 
prol og. 

2*16 M£8_£Ill*!U&]2.£011Mtmi 

The following commands provide a nonstandard means of 

performing various frequently performed functions* They will be 

superceded in subsequent builds by standard commands and 
capabi titles. 

2.16.1 DELETE_CATALQ€_CONT£NTS J OELCC (NEU) 

The purpose of this command is to delete all entries from the 
specified catalog. This includes subcatalogs and the files they 
contain. 

delete_catal og.con tents tcataiog«<catalog>3 

Cstatus*<status variable>3 

catalogues This parameter specifies from which catalog all 
files are to be deleted. Omission will cause 
the current working catalog to be used, 

statust See ERROR HANDLING. 

2.16.2 DISf>LAY_ACTlV£_TASK J DISAT (NEW) 

The purpose of this command Is to display task statistics for 
all currently active tasks in a job. The following information 
is displayed. 

task name 

execution time use 
number of page faults 

dlspl ay_ active. task £output»<f J I e >3 

tstatus*<status varlable>3 

output'oi This parameter specifies the file to which the 
task statistics is displayed. Omission will 
cause SOUTPUT to be used. 
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2.0 C0HMAN0 INTERFACE STATUS 

2.16.3 DISPLAY_$YST£N_DATA J 0ISS0 (NEW) 

mmm mmmm m m m m mm m m m m m m m m m m m mmmmmmm mmmmmmmmmm mm m m m m m m m m m m mm m m m m m m m m m m m m m 

2.16.3 DISPLAY_SYST£M_DATA 1 DISSD (NEW) 

The purpose of this command Is to display system page fault 
statistics and system monitor request statistics. 

di spl ay.system.dat a Cdi splay.opt I on«page_f aul ts Jpf 

5 moni tor.requestsJmrlall 
tdlsplay_f or ma t» incremental ? I * total J tl 
Coutput»<fi le>l 
tstatus»<status variabie>3 

displ ay.opt i oni do* This parameter specifies which 

statistics are to be displayed. The 
following options are allowed * 

page_faults - display the page 

fault statistics. 

mon i tor.reque sts - display the system 

monitor request 

stati st Ics. 

Omission will cause AIL to be 

used. 

displ ay_formatl df * This parameter specifies whether a 

display of the alt statistics recorded 
so far (total) or only these statistics 
recorded since the last 

display. system_data command 

(incremental) should be displayed. 
Omission will cause incremental to be 
used. 

outputJot This parameter specifies the file to 

which the system data will be 

displayed. Omission will cause SOUTPUT 
to be used. 

status* See ERROR HANDLING. 

2.U.4 !>ISPIAY_J0B_DATA 1 DISJD (HEM) 

The purpose of this command is to display the following job 
related statistics: 
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time in job mode 

time In monitor mode 

count of page In operations 

reclaimed pages 

new pages assigned 

working set size 

count of ready tasks 

dlspl ay_ job_data t di spl adoption* jo b_d at a 1 

C dl spl ay. form at* In ere mental * I * total f t] 

Coutput*<f I le>3 

t status«<s tatus varlable>3 

dlspl ay_optlon*do* This parameter specifies which 

statistics are to be displayed* The 
following options are allowed: 

job.data - display job related data. 

Omission will cause job_data to be 
used* 

dlspl ay.formatJ df* This parameter specifies whether a 

display of the all statistics recorded 
so far (total) or only those statistics 
recorded since the last d Ispl ay_job.dat a 
command (incremental) should be 

displayed* Omission will cause 

incremental to be used* 

outputlo* This parameter specifies the file to 

which the job data wilt be displayed* 
Omission will cause SQUTPUT to be used* 

status! See ERROR HANDLING. 

2*16.5 DISRLAY.COMMAND.INFORMATION J OISCI 

The purpose of this command is to display current Information 
about a NGS/VE command* The parameter names* abbreviations* 
allowed values and known problems for a command* as supported in 
the current system* can be determined* This is a nonstandard 
command and will be replaced by the help utility sometime in the 
future* 

dlspl ay.command.lnf ormation command_name«<name>* a I I 
Cut! 1 1 ty_name*create_ob ject.l i brary' 
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2.0 COMNAND INTERFACE STATUS 

2«16«5 QISPtAY_COMMAND_INFORMATION I DISCI 

col » source_code_ut iiityJscuSsystemJ 
C displ ay_opti on* par ameter_descr i ption_tabl e! 

pdt J notes 'names' he I pi 
Coutput«<f I le referenced 
tstatus«<status varlable>l 

command_nameJ en * This parameter specifies the name of the 

command about which Information is to be 
displ ayed. 

uti M ty_namej un* This parameter specifies which utility the 

command belongs to* Omission will cause 
SYSTEM to be used. 

displ ay_option! do J This parameter specifies the type of 

display being requested. The options arei 

parameter^descr ipti on_table Jpdt - selects 
a display of the parameter descrip- 
tion table used by the command wher 
executed. 

notes - selects a display of any known 
problems with the command. 

names - selects a display of the command 
names for a ut i I Ity • 

help - selects a display of the coirmand 
interface description of the command. 

Omission will cause PDT to be used. 

output'ot This parameter specifies the file to which 

information will be displayed. Omission 
will cause SOUTPUT to be used. 

status? See ERROR HANDLING. 

2.16.6 CONVERT_OBJ£CT_FILE ? CONOF 

The purpose of this command Is to set a NOS/VE object file 

produced on NOS and to convert it to an object file suitable for 

processing by the NOS/VE loader or object code maintenance 
commands * 

convert_object.fi I e to»<flle reference> 
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2.16*6 CQNVERT_GBJECT_FILE J CONOF 
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Cfrom»<name>l 
Cuser«<name>l 
£status«<status variable>] 

toJti This parameter specifies the NOS/VE file name on 
which the converted object file Is to be written. 

frowjft This parameter specifies the name of the NOS file to 
be converted* This is the permanent file name as 
defined in the NOS file system and can be up to seven 
characters in length. 

Omission will cause the permanent file name of the 
TO parameter to be used. 

userlu* This parameter specifies the NOS user identification 
of the owner of the file. This parameter Is only 
neccessary if the file is in a catalog other than the 
user who was specified by the most recently issued 
SET_LINK_ATTRIBUTES command. 

status* See ERROR HANDLING. 

2.16.7 GET_OBJECT_FILE ! GETOF 

The purpose of this command is to get a previously converted 
NOS/VE object file from the NOS side and sets the appropriate 
file attributes that will allow the object file to be used by 
NOS/VE. 

get. object. file to*<fiie reference> 

Cf rom*<name>3 
tuser*<name>l 
£status*<status variable>3 

to! t* This parameter specifies the NOS/VE file name of the 
object file. 

fromSfi This parameter specifies the NOS file name of the 

object file. This is the permanent file name as 

defined in NOS and can be up to seven characters in 
length. 

Omission will cause the permanent file name of the 
TO parameter to be used. 

user*u< This parameter specifies the NOS user identification 
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2.16.7 GET_08JECT_FILE ? GETOF 
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of the owner of the flle» This parameter Is only 
necessary if the file is in a catalog other than the 
user who was specified by the most recently issued 
SETJ.INK.ATTRIBUTES command. 

status* See ERROR HANDLING. 

2.16.8 GET^OBJECT.tlBRARY S GETQL 

The purpose of this command is to get a previously created 
NOS/VE object library from the NOS side and set the appropriate 
file attributes that will allow the object library to be used on 
NOS/VE. 

get.object.li br ary to«<file reference> 

C f rom«<name>l 
Cuser«<name>1 
C status*<status variable>3 

to5t« This parameter specifies the NOS/VE file name of the 
object I ibrary. 

fromSfi This parameter specifies the NOS file name of the 
object file. This is the permanent file name as 
defined in NOS and can be up to seven characters in 
length* 

Omission will cause the permanent file name of the 
TO parameter to be used. 

useriui This parameter specifies the NOS user identification 
of the owner of the file. This parameter is only 
necessary if the file is in a catalog other than the 
user who was specified on the most recently issued 
SET_LINK_ATTRI3UTES command. 

status! See ERROR HANDLING. 

2.16.9 DISPLAY.oBJECT.TCXT i DISOT 

The purpose of this command is to produce a formatted display 
of the object text contained in an object file or object library 
produced on NOS/VE. 

display.ob ject_text f 1 I e-<f I le> 
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2,0 COMMAND INTERFACE STATUS 

toutput«<f I le referenced 
Cstatus»<status variable>] 

flieSf* This parameter specifies the object file or object 
library containing the object text to be listed. 

outpytio* This parameter specifies the file to which the 
display Is to be written* 

Omission will cause the file SOUTRUT to be used. 

status* See ERROR HANDLING. 

2.16.10 EDIT.FILE S EDITF 

The purpose of EDIT.FILE is to Initiate the execution of the 
SCU editor on a text file. (For details see ARH3883.) 

edlt.fi le * editf - edit lines on a source file. (procedure file 
not necessarily in Its final form) 

file-file (source) $REQUIR£D 

Cresult.fi le(source)! SVALUE(FILE) 

Clnput»fi1e reference 1 $C0MMAND 

Coutput«file referencel SOUTPUT 

[status] __ 

2.16.11 JEDIT 

The purpose of this command is to initiate execution of the 
JEDIT editor built by Jack Bohnhoff. Anyone wanting Information 
about the editor should contact Jack. 

jedit from»<flle> 

tstatus«<status varlable>] 

fromjf* This parameter specifies the file to be editted. 
This file Is rewritten after the editor 
terminates. 

status! See ERROR HANDLING in the NOS/VE Command 
Interface. 
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2.0 COMHAN0 INTERFACE STATUS 
2.16.12 DEBUS 



2.16.12 DEBUG 

The prototype Rl NOS/VE debugger is now available. Details on 
how to use the debugger can be found in the "CYBER 18C 
INTERACTIVE DEBUG External Reference Specification and User's 
Guide"* Sunnyvale DCS number S4028. 

2.16.13 SET_tINK_ATTRIBUTES 1 SETIA 

The SET_LINK_ATTRI8UTES command is the same as documented in 
the NOS/VE command interface with the exception that the CHARGE 
and PROJECT parameters are optional (and in fact not useful in 
the current environment since we disable that feature on the NOS 
side). 
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3.0 PROGRAH INTERFACE STATUS 



3.0 ££J3&£AJ3UM£E£Aa£-SIAIUS 



The •status 1 column Indicates whether the procedure Is 
unchanged from the previous build* modified from the previous 
build or not available In this build* Footnotes are numbered 
within each section. 



3.1 £2MAiiQ-£afl££SSXti£ 

CLP*5CAN_PARAM«LIST 

CLP$TEST_PARAM£T£R 

CLP$GET_KEYWORD 

CLPSGET.SETJTOUNT 

CLP$GET.VALUE_COUNT 

CLPSTESTJUNGE 

CLPSGET.VALUE 

CLPSCREATE.VARIABLE 

CLP$DELETE_VARIABL£ 

CLP$R£AD_VARIABL£ 

CLP$WRITE_VARIA8LE 

ClP$SCAN^COMMAND_FIL€ 

CtPSENO.SCAN.COHMAND.FILE 

CLPISCAN.COHMANO LINE 

CLP$CREATE_FILE_CQNNECTION 

CIPSOEIETE.EILE.CQNNECTION 

CLP$PUSH/POP_UTILITY 

CLP$GET_C0MMAN0 ORIGIN 

CLP$GET_DATAJ.INE 

CLP$SCAN.PROC. DECLARATION 



Status 



unchanged 








unchanged 








unchanged 








unchanged 








unchanged 








unchanged 








unchanged 








updated to 


ERS 


Rev. 


8 


updated to 


ERS 


Rev. 


8 


updated to 


ERS 


Rev* 


8 


updated to 


ERS 


Rev. 


8 


unchanged 








unchanged 








unchanged 








unchanged 








unchanged 








unchanged 








unchanged 








unchanged 








unchanged 









3*2 tl££SA£L-££ti£&4ia£ 
£tafi£4ur.£ 

QSPSFORMAT.MESSAGE 

OSP$SET_STATUS_ABNORMAL 

0$P$APPEND_STATU$j>ARAMETER 

aSP$APPEND_STATUS_INTEGER 



unchanged 
unchanged 
unchanged 
unchanged 
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3.0 PROGRAM INTERFACE STATUS 
3.3 RESOURCE MANAGEMENT 



3.3 R££aU&CE~8AttA££8B*I 

Etflfi£iliJ££ 

RMP$REQUEST_MASS_STORAGE 
RMP$R£Qu£ST_T£RMINAL 



unchanged 
unchanged 



All terminal attributes can be specified on the 
RMP$REQUEST_TERMINAL call but only the following are operational* 

o auto_ Input 
o tr ansparent_n»ode 
o pro»pt_f i I e 
o pr o»pt_str ing 



Files assigned to a terminal 
following SAM requests* 



device can be accessed via the 



AMPSO 
AMPSG 
AM P$ G 
AMPSG 
A1PSP 
AM PSP 
AMPSP 
AMPSC 
AMPSR 
AMPSS 
AM P$S 



PEN 

ET_NEXT 

ET.OIRECT 

ET.PARTIAL 

UT.NEXT 

UT_DIRECT 

UT.PARTIAl 

LOSE 

EWIND 

KIP 

EEK_DIR£CT 



3.4 £SJ3SEAflL£l££JJIII3ii 
&££fiL£dti££ 

PMPSEXIT 

PMPSEXECUTE 

PMPSTERMINATE 

PMPSAWA I T.TASK. TERMINATION 

PMP$MODULE_TABL£ ADDRESS 

PMP$ENTRY_PQINT TA8LE.ADDRESS 

PMP$PUSH.TASK«DEBUG.MOD£ 

PMPS5ET_TASK_DEBUG_M0D£ 

PMPSTASK.DE BUG_MGDE_ON 

PMPSSET_DEBUG_RING 

PMP$DE8UG_RING 

PMPSCHANGE.DEBUG LIBRARY_LIST 

PMPSPOP_TASKJ>EBUG_MODE 



SlaiJIS 



unch 
unch 
unch 
unch 
unch 
unch 
unch 
unch 
unch 
unch 
unch 
unch 
unch 



anged 
anged 
anged 
anged 
anged 
anged 
anged 
anged 
anged 
anged 
anged 
anged 
anged 
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3.0 PROGRAM INTERFACE STATUS 
3.5 PROGRAM COMMUNICATION 



3,5 ££0£&Ail.£i3ttilU!iI£AIX0tJ 

£££S£4ll££ 

OSP$AWAIT_ACTIVlTY_CGMPL€TION 
PMP$DEFINE_QUEUE 
PMP$REMOVE_QU£U£ 
PMPICONNECT.QUEUE 
PMPSDISCONNECT QUEUE 
PMPSSEND.TO.QUlUE 
PMPIRECEIVE FROM QUEUE 
PNP$STATUS_QUEUE 
PNPSSTATUS.QUEUES DEFINED 
PMPSGET QUEUE LIMITS 



iialMS 



unch 
unch 
unch 
unch 
unch 
unch 
unch 
unch 
unch 
unch 



anged 
anged 
anged 
anged 
anged 
anged 
anged 
anged 
anged 
anged 



3 . 6 £J31JQIIIJ21L£&QCJE£5LK£ 
EtQCfidurjB 

PMPSESTABLISH.CQNDITION.HANDLER 

PMP$ 01 SESTABLISH.COND.HANOLER 
PMPSCAUSE.CGNDITION 
PMPSCONTINUE.TO CAUSE 
PMP$TSST_CONDITION_ HANDLER 
PMP$ VALIDATE. PRE VIOUS.S AVE. ARE A 
PMPSESTABLISH.DEBUG.OFF 
OSPSSET.STATUS.FROM.CONDITION 



Added support of detected 

uncorrected error 

unchanged 

unchanged 

unchanged 

unchanged 

unchanged 

unchanged 

unchanged 



3.7 £&rj&ftA£-lE&a&££ 

tZAGMULt 

PMP$GENERATE.UNIQUE.NAME 

PMP$GET_TIM£ 

PMP$G£T.MICRQSECOND. CLOCK 

PMPSGET.TASK CP TIME 

PMP$GET_DATE 

PMPSGET.USER.IDENTIFICATON 

PMPSGET.ACCOUNT.PROJECT 

PMPSGET.JOB.NAMES 

PMP$GET_JOB_ID 

PMP$G£T_J08_M0DE 

PMPSGET.PROGRAM 

PMPtGET.TASK.IO 

PMP$MANAGE_SENSE SWITCHES 

PMP$GET_OS_V£RSION 



Status 



unch 
unch 
unch 
unch 
unch 
unch 
unch 
unch 
unch 
unch 
unch 
unch 
unch 
unch 



anged 
anged 
anged 
anged 
anged 
anged 
anged 
anged 
anged 
anged 
anged 
anged 
anged 
anged 
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3.0 PROGRAM INTERFACE STATUS 
3.7 PROGRAM SERVICES 



PMP$ GSTJ>R0C£SS0R_ATTRI8UT£S 
PMP$0£fINE_D£8UG_ ENTRY 
PMP$G£T_DEBUG_ENTRY 
PMP$M3DIFY_DE8UG_ ENTRY 
*>MP$REMOVE_DEBUG ENTRY 



unchanged 
unchanged 
unchanged 
unchanged 
unchanged 



3*3 LQfiSISS 

££A25dU££ 

PMPILGG 
PflPSLOG.ASCII 



unchanged 
unchanged 



3.9 £Ii£J!Aia££iOI 
ELA£fidU£* 

Sequential Access 

3yte_Addressab le Access 

Record Access 

Segment Access 

V_System Specified 

V_User Specified 

U. System Specified 

U_User Specified 

F.System Specified 

F_User Specified 

AMP$OESCRIBE.NEW.FRE 

AMPSFIIE 

AMP$GET_FIL£_ATTRI8UTES 

AMPSFETCH 

AMPISTORE 

AMP$COPY_FILE 

AMPSRENAME 

AMPS RE TURN J= HE 

AMPSQPEN 

AMPSCIQSE 

AMP$FETCH_ACCESS INFORMATION 

AMPS SKIP 

AMPS REWIND 

AMPSWRITE_END_PARTITION 

AMPSGET^NEXT 

AMPSGET_DIR£CT 

AMPSGET_PARTIAL 

AMPSPUT_N£XT 

AMPSPUTJHRECT 

AMPS PUT PARTIAL 



unchanged 

unchanged 

unchanged 

unchanged 

unchanged 

unchanged 

unchanged 

unchanged 

unchanged 

unchanged 

del eted 

unchanged 

unchanged 

unchanged 

unchanged 

unchanged 

unchanged 

new name 

unchanged 

unchanged 

unchanged 

unchanged 

*2 

unchanged 

unchanged 

unchanged 

unchanged 

unchanged 

unchanged 

unchanged 



- *1 



- *3 
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3.0 PROGRAM INTERFACE STATUS 
3.9 FILE MANAGEMENT 



AMP$SEEK_DIR£CT unchanged 

AMPSG£T_S£GMENT_POINT£R unchanged 

AMP$SET_S£GMENT_£OI unchanged 

AMP$SET_SEGMENT_POSITION unchanged 

AMP$S£T_LOCAL_NAME_ABNORMAL unchanged 

AMP$$ET_FIL£_INSTANCE_ABNORMAL unchanged 

AMP$ACCESS_ METHOD unchanged 

AMP$FETCH_FAP_POINTER unchanged 

AMP$STORE_FAP_POINTER unchanged 

*1 Segment access If a segment access file Is written and an 
AMP$SET_SEGMENT_£OI is not Issued to record the £01* EOI 
remains zero* The highest page referenced is not yet used as 
the default £01. This particularly affects those who wish to 
make heaps permanent because EOI Is always zero for a heap* 

*2 AMP$*£tfIND The MAIT parameter on the procedure call Is not 
supported* 

*3 AMP$PUT_PARTIAL PUT.PARTIAI with the TERM_QPTIGN 

AMCSTERMINATE does aat act as a put_next If a preceding START 
was not Issued* 



3.10 ££&!iAMai-£IL£-M!a££&£JiI 



££fifi£jfil££ 


Sijtus 










PFPSDEFINE 


updated 


to 


ERS 


Rev. 


9 


PFPSATTACH 


updated 


to 


ERS 


Rev. 


9 


PFP$ PURGE 


updated 


to 


ERS 


Rev. 


9 


PFPSCHANGE 


updated 


to 


ERS 


Rev. 


9 


PFP$P£RMIT 


updated 


to 


ERS 


Rev. 


9 


PFPIOELETE.PERMIT 


updated 


to 


ERS 


Rev. 


9 


PFP$DEFINE_CATALCG 


updated 


to 


ERS 


Rev. 


9 


PFP$PURGE_CATA10G 


updated 


to 


ERS 


Rev. 


9 


PFPSPERMIT.CATALOG 


updated 


to 


ERS 


Rev. 


9 


PFP$DStETE_CATALQG_P£RMIT 


updated 


to 


ERS 


Rev. 


9 



3 • 11 ££ttMX-£4M££iOI 

MMPSAOVISE.IN 
MMP$ADVISE_QUT 
MMP$ADVISE_OUT_IN 
MMPSMRITE.MOOIFIED PAGES 
MMPSCREATE.SEGMENT 
MNPSD£LETE_SEGMENT 
MMPSSTORE.SEGMENT.ATTRIBUTES 
MMP$FETCH_S£GM£NT ATTRIBUTES 



unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
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3,11 MEMORY MANAGEMENT 



MMP$VSRXFY_ACC£SS unchanged 

MMPSFREE unchanged 

MMP$tQCK_PAG£5 number of locked pages per 

NMP$UNLGCK_PAGES segment restricted to 32 

MMP$F£TCH_PVA_UNWRXTTEN_PAGeS unchanged 

3.12 SI4IISII£i-£AaiIII 

SFP$€STA81ISH_STATISTIC unchanged 

SFP$£NABLE_STATISTIC unchanged 

SFP$DfSABL€ STATISTIC unchanged 

$FP$OISESTABUSH_STATISTIC unchanged 

$FP$ENIT_STATISTIC unchanged 

SFP$EMIT_SY$TEM_STATI$TlC unchanged 

3.13 ItilU&LllXE-ZkLlLIU 

IFPITERMINAL unchanged 

IFP$F£TCH_T£RMINAL unchanged 

IFPSSTORE.TERMINAL unchanged 

IFPSGET.OEFtT.TERMINAL. ATTRIBUTES unchanged 

IFP$GET_TERMINAL_ATTRI8UT£S unchanged 

IFPSADVANCE new - *1 

*1 Only the option IFC$ADVANCE_ALL_QUEU£D_OUTPUT Is supported, 

3.14 BQSI¥I-OdfEIIQ85 

The following summarizes the exception code ranges currently 
assigned to NOS/VE* These code ranges represent a finer 
breakdown than the one specified in the SIS for internal NOS/VE 
development purposes* However* it is important to remember that 
only the product identifiers documented in the SIS may appear in 
error messages. 

Common Modules 9,000 - 9*999 

Common Code Generator 8*000 - 8.999 

Product 
Exception Code Identifier Product Name 

1 — ■ 158*999 Reserved 

159,000 - 159,999 SY System Core 

160*000 - 169,999 AM Basic Access Methods 

160,000 - 163,999 BA Basic Access 
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164, 

165, 

166, 

167, 

170*000 

180,000 

190,000 

200*000 

200, 

205, 

210,000 

210, 

211, 

212, 

213, 

214, 

215, 

216, 

217, 

218, 

219, 

220,000 

221, 
222, 

230,000 
240,000 
250,000 
260,000 
270,000 
280,000 
290,000 
300,000 
310,000 
320,000 
340,000 
330,000 
500*000 
510,000 
520,000 
530*000 
540,000 
550,000 
560,000 
570,000 
580,000 
590,000 
600,000 
610*000 



000 - 164,999 
000 - 165,999 
000 - 166,999 
000 - 167999 

- 179,999 

- 189,999 

- 199,999 

- 209,999 
000-204*999 
000 - 205*999 

- 219*999 
000 - 210*999 
000 - 211*999 
000 - 212*999 
000 -■ 213*999 
000 - 214*999 
000 - 215*999 
000 - 216*999 
000 - 217*999 
000 - 218*999 
000 - 219*999 

- 229*999 



000 - 2 
000 - 2 

- 239 

- 249 

- 259 

- 269 

- 279 

- 289 

- 299 

- 309 

- 319 

- 329 

- 349 

- 339 

- 509 

- 519 

- 529 

- 539 

- 549 
559 
569 
579 
589 
599 
609 
619 



21*999 

22*999 

999 

999 

999 

999 

999 

999 

999 

999 

999 

999 

999 

999 

999 

999 

999 

999 

999 

999 

999 

999 

999 

999 

999 

999 



IN 
JF 
SR 

CH 
CL 

jm 

LL 

MM 
MM 
MM 
OS 
OS 
MT 
10 
10 
DM 
ML 
IF 
TM 
TM 
JS 
PF 

ST 

PU 

PM 

RM 

OF 

AV 

IC 

RH 

OC 

DB 

MS 

Reserved 

SF 

US 

AA 

AG 

AL 

AP 

BA 

CA 

CB 

CY 

FT 

PA 

PI 

SM 



Local Nam 
Job Fi |e 
Conversio 
Conf I gura 
Command L 
Job Manag 
Loader 
Memory Ma 
Monitor L 
Task Leve 
Operating 
OS 
EXEC 
MS I/O 
Tape I/O 
Device Ma 
Memory Li 
Interactl 
TM Moni to 
TM Task 
Job Swapp 
Permanent 
Managemen 
Set Manag 
Permanent 
Program M 
Resource 
Operator 
User Admi 
Interstat 
Remote Ho 
Object Co 
Deads tart 
Maintenan 



e Mgr 

Mgr 

n Services 

tion Mgmt 

anguage 

ement 

nagement 
eve) 

I 
System 



nagement 

nk 

ve 

r 

«rs 

File 
t 
ement 

File Uti liti es 
anagement 
Management 
Faci lity 
ni strator 
e Communication 
st Fac i I i ty 
de Uti I ities 
/Recovery 
ce Services 



Stati sties Fac« 

User Errors 

Advanced Access Method 

ALGOL 

Assembly Language 

A PL 

BASIC 

Conversion Aids System 

COBOL 

CYBIL 

FORTRAN 

PASCAL (Wirth) 

PL/1 

Sort Merge 
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620*000 - 629,999 SC Source Code Utility 

640,000 - 649,999 08 Debug 
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4,0 DUAL STATE DEADSTART AnO OPERATION 



4.0 &UALJiim_J2£AmMI-M&-G£££AIIim 



4.1 Cm£8IJiyAUSIAl£_£Q&£l£U£AII!]$i 

The Arden Hills S2 development systems are configured to run 
with three FMD units. 

o FMD Unit 43 

This unit contains the following* 

- A170 NOS (5.3 as released)* CTI, MSU £1 binaries, NOS 
deadstart f I les 

Files associated with user name LIBRARY 
Files associated with user name S£S 

- Files associated with 0EV1# DEV2# REL1, INT1. 

o FMD Unit 41 

This unit contains the following* 

- Files required to deadstart dual state Cycle 3) A170 NOS 
(5.3 plus changes necessary for Cycle 3)# CTI* MSL» El 
binaries* and NOS Deadstart files. 

- It is also used as a temp device. 

o FMD Unit 42 

This unit contains the following! 

-■ NOS/VE Development Area PL f s and Member PL's 

- NOS/VE Deadstart Files to be tested (saved In individual 
user's catalogs) 

- Files associated with user name INT2 

o FMD Unit 44 

This Is another NOS PF device. 
o FMD Unit 45 

This is another NOS temp device. 
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4 .2 USES JiMIS-MD-E£EMH£fciI JEIL£S 

1) The convention used for creating user naies on NOS/VE is as 
f ol Ions* 

o Your user name will be your initials* 

o Your password will be these 3 letters followed by the 

letter *x». 
o You must see CONSOURCE (R.K. Cooper - x3092) to be 

assigned a user index 

2) PF dumping and loading 

You may use W S£$ .DUMPPF" on SN/101 to dump your permanent 
files to tape* and then load them onto your user name on A17C 
NOS using "SES.LQADPF". Documentation on how to use these SES 
procedures and what their parameters are is included in the 
SES User*s Guide* or they can be obtained by typings 

SES* HELP.DUMPPF and SESjHELP.LOADPF. 

At deadstart time NOS will automatically load 7155-lx disk 
controlware on one channel with controller type»FM CLBC CMRdeck 
entry)* and will automatically load 7155-4x disk controlware on 
any channel with control ler type*HT (LBC CMRdeck entry). NGS/VE 
supports both of those types of controllers* NOTE* It Is not 
possible to use 844 half-track controlware in this environment. 

4.4 A12flJ»DS-li£A0m&I 



4.4.1 CTI AND CHECKING CENTRAL MEMORY 



Deadstartlng A170 NOS assumes some knowledge of CTI. CTI 
stands for Common Test and Initialization. It is software that 
places an 300 series machine in a state such that it is possible 
to deadstart an operating system. CTI is used somewhat 
ambiguously in the software community to imply CTI and MS L 
(Maintenance Software Library). The MSL is a collection of 
programs and data that includes such things as a subset of CM S E 
(Cyber Maintenance Software Executive) that enables one to load 
controlware to controllers* look at CYBER 180 maintenance 
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4.0 DUAL STATE OEADSTART AnD OPERATION 

mmmmlmmZlmmmm mm^mmlmmmmmmlmimmmmm^^ 

registers* look at microcode* etc. The MSL also contains 
microcode that can be loaded by C TI • The MSI is actually an 
operating system that runs independently of NOS. An important 
element of CTI/MSL is HIVS (Hardware Verification Sequence)* 
which is a program that loads microcode* clears and checks 
central memory and tests all 170 opcodes* If you are not sure 
what the machine was used for (particularly the first hands on 
user each morning) then the HIVS program should be run. This is 
accomplished by* 

1) deadstart to NOS/VE (unit 40 for S3* unit 41 for S2) 

2) Enter (operator intervention) 

3) Enter P (deadstart panei*make sure level deadstart) 

4) <BKSP> 

5) Enter H (assure yourself that CS*YES to reload microcode) 

6) <BKSP> 

7) Enter V (verification sequence) 

8) Hit <CR> at •parameter display 1 to test CM € CP 

When you see text that tells you that verification is complete 
and a deadstart is required* you are now ready to deadstart NOS* 

4,4.2 NOS DEADSTART 



See Section 3.3 of the Integration Procedures Notebook for 
important NOS CMRDECK changes. 
o Set the D/S panel to deadstart from the primary system disk. 

This Is Unit 41 for all Cycle 2 systems. 
o Push D/S button 
o Enter (CR) 
o Enter date/time 

Wait for deadstart to complete. 

Note! The deadstart tape DUAL34 (which is currently installed on 
unit 41) is found in the area in the northeast corner of the S2 
lab where the tape cabinet is found. 
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4.4.3 INITIALIZING AN 885 



If an 885 is powered down (processor) it may be impossible to 
deadstart or even run the HIVS program* The reason is that 
powering up does not master clear the maintenance channel* This 
is a known problem and is being addressed by CDED. The way to 
solve this problem currently is to used the CNSE equivalent of 
the HIVS program. That program can be executed by performing an 
alternate deadstart to the eng ineer* s/CE's CMSE pack* entering M 
C to select maintenance)* entering a CR at the menu screen* and 
then entering •GO INIT39 1 . INIT39 is a CHSE command buffer and 
will require about 2 to 3 minutes to complete. When the display 
shows a •TB 1 (terminate buffer) the initialization is complete. 
The 39 stands for a microcode cycle* i.e. the 885 is currently 
using cycle 39 microcode. 

4.5 8aS£2E-&E4£mBI_AM£.iamLLAIIQil 

o Enter D0WN*CH2. so NOS/VE can use the channel. 

o Enter DQWN*CH32. so NOS/VE can use the channel. 

o The following file must be available in your catalog on the 
S2t 

TPXXXK contains a NOS/VE deadstart image. This roust be a copy of 
the dual state deadstart images available from the link 
procedures. 

o If you've never deadstarted NOS/VE from the user number from 
which you want to run or if you wish to change the current 
parameter settings for your particular user number* then do a 
SETVE. SETVE assumes the file TPXXXK is in your user number* 
you do not have to do another SETVE if TPXXXK has changed 
since the last time you ran. The general form of SETVE is* 

X. SETVE CPN«ffff*UN«un*06) 

where ffff is an identifier of up to 4 characters and un is 
the user number to search first for files. 6 is the number of 
the system core command deck for the Arden Kills 
configuration. In general ffff and un will be the same* e.g. 
X. SETVE CDAH*UN«DAH»C«6) 

**0nl y ONE SETVE should be done for each user number and 8 
SETVE should NOT be done for ANY Integration user number 
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4.0 DUAL STATE DEADSTART AnD OPERATION 
4.5 NOS/VE OEADSTART AND INSTALLATION 

mmm m mmm mmmm mm m mm m m m m m mm mm m mmmm m mm m mm m mmm m mm mm mm mmmmmm Mmmmmm mmmm mmmm m 

except by the Integration project.** 

SEE SECTION 5.1 FOR MORE DETAILS. 

o Bring up dual states 

N.NVEffff. 

where n Is any control point number except 1.2 and the 
3ATCHI0* MAGNET £ SYSTEM control points and ffff Is the 
Identifier specified in SETVE, e.g. 4.NVEINT1. 

o 3r|ng uP the Operator Facility 

Enter k.2 - where 2 is the control point of the TAFNVE 
job* 

NOS/VE is currently generated and initialized on both NQS 
and NOS/VE. All source and object libraries that make up the 
NOS/VE system are produced on NOS and therefore must be 
converted from their Ci to II counterparts. Other parts of 
installing and Initializing the system (e.g. building the 
ISYSTEM catalog) are performed by command language procedures 
on NOS/VE. Since the same system will many times in a closed 
shop environment* it is advantageous to only perform the 
conversion from CI to II a single time: save the results in 
the NOS file system and then simply bring the files back 
during deadstart. 

The actual files that get Installed and loaded on each 
deadstart are determined by a command language procedure (the 
system profile) interpreted on NOS/VE, This procedure can be 
modified by each site to initialize their NOS/VE environment 
in the most suitable fashion. The process of building the 
system profile and of performing the CI to II conversions is 
referred to as an installation deadstart and the process of 
executing the system profile and of fetching previously 
converted files from NOS and making them available in the 
NOS/VE file system is referred to as a deadstart. A single 
command Is available to perform both an installation deadstart 
and a deadstart. 

4.5.1 THE DS PROCEDURE 

The purpose of this command Is to perform an Installation. 
normal or recovery deadstart of NOS/VE. The defaults for 
parameters are those most convenient for "closed shop" 
deadstarts. 
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4.0 DUAL STATE DEADSTART AND OPERATION 
4.5.X THE OS PROCEDURE 

The procedure *»brings up w the Job log display on the left 
screen where the progress of the procedure may be watched* and 
the control point display on the right screen. Just before 
the procedure changes the left screen to display the system 
log and writes to that log the message* 

!_— . Deadstart Completed * 

at which point the operator may enter commands. 

ds tkind« instal I J normal J recover! 
tget. source. I ibrar ies*<bool ean>1 
CgetZproducts»<boolean>3 
Cecho«<bool ean>3 

Cal te mate. user«<NGS.use r„t\ am e>3 
Csave.install.fil es*<bool ean>1 
Cv al I date.users»<bool ean>l 
Cdebug*<bool ean>3 
Chelp«<file referenced 
Cstatus*<status variable>] 

kind S kt This parameter specifies what kind of deadstart is 
to be performed. Valid specifications are* 

Install J i - installation deadstart to be performed. 
The system libraries are built from CI object 
files. 

normal * n - normal deadstart to be performed. The 
system libraries are obtained from the results of a 
previous installation deadstart. 

recover S r - recovery deadstart. Just initiates system 
tasks. Permanent files are "recovered" from a 
previous run of the system. 

Omission will cause a recovery deadstart to be 
performed. 

get.source.l ibrar ies S gs It This parameter specifies whether 
SCU libraries are to be installed. Valid specifications 
are* 

true 1 yes * on - libraries are to be installed 

false I no S off - libraries are not to be installed 
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On the Arden Hills closed shop S2 system* the SCU 
libraries to be installed ares 

OSFPIl -> aSF$PRGGRAN_INT£RFAC£_LIBRARY: operating system 
program interface 

OSFSL -> 0SF$saURCE_LI8RARY: subset of operating system 
source library 

Omission will cause SCU libraries to be Installed* 

get_products * gp: This parameter specifies whether the object 
libraries defining the current product set are tc be 
installed. Valid specifications are: 

true ! yes * on - the products are to be installed 

false 5 no I off - the products are not to be installed 

On the Arden Hills closed shop S2 system, the product 
set to be installed consists of: 

CYFIIC -> CYF$COMPIl€R: cybif II compiler 

CCFRTL -> CCF$RUN_TIHE_ LIBRARY: common compiler modules 
run time I i br ar y 

MLFRTL -> HIF$RUN_TIME_LISRARY: math run time library 

08FDL ~> DBF$D£BUG. LIBRARY: symbolic debug library 

SCFOL -> SCF$OBJECT_LIBRARY: source code utility 

SCFCL -> SCF$C0M?1AN0_LIBRARY: source code utility 
"stand-alone" command library 

IFFEDIT -> IFFSEDITOR: Jack Bohnhoff's editor (JEDIT) 

Omission will cause the product set to be Installed* 

echo t e: This parameter specifies whether the commands should 
be echoed to the console during execution* Valid 
specifications are: 

true • yes • no - echo commands 

false J no 5 off - do not echo commands 

Omission will cause commands not to be echoed* 
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a) ter nate.user « au* This parameter specifies what NOS user to 
check If the default NVE user does not have the needed 
file* Any NOS user name Is allowed. 

Omission nil I cause INT1 to be used. 

save. instal l.f i I es I sifs This parameter specifies whether to 
save the system libraries created by an Installation 
deadstart* This parameter is ignored for a normal or 
recovery deadstart. Valid specifications are* 

true * yes 5 no - save the installed system libraries 

false ! no ! off - do not save the installed system 
I ibrari es 

Omission Mill cause the files not to be saved. 

val Idate.users J vu* This parameter specifies whether to run 
the job that validates NOS/VE users. This parameter is 
ignored for a recovery deadstart. Valid specifications 
ares 

true * yes • no - run the validation job 

false 5 no S off - do not run the validation job 

Omission will cause the validation job to be run. 

quick. val idate * qvt This parameter determines which users 
will be validated by the validation job if it is run. 
When specified* this parameter gives a list of user names 
to be validated in addition to the users* INT1* INT2» 
OEVlt DEV2. REll* EVAL and RKC . 

Omission wilt cause all users to be validated* 

debug 3 d* This parameter specifies whether the procedure 
should abort if an error condition Is detected* Valid 
specifications are* 

true ! yes 5 no - do not abort on an error. The user 
will be prompted for commands in the event of an 
error at which time enterrr ing "continue 11 will cause 
processing to resume. 

false S no I off - abort on an error 

Omission will cause the procedure to 8bort when an 

Cycle 3* Hay 1982 



NOS/VS Cycle 3 Helpful Hints 



4-9 
05/24/82 
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4.5.1 THE OS PROCEDURE 



error is encountered. 

help * h* This parameter specifies whether help information is 
to be written. If this parameter is specified* the help 
information will be written to the specified file and the 
procedure will terminate. 

Omission will cause the procedure to execute and the 
help information not to be written. 

status* See ERROR HANDLING in the NOS/VE ERS. 



If you change any of the following decks you MUST use the 
installation deadstart from your own catalog (with files 
CY8ILG0* XLJOCM, XUOSU XLJLIB and XLJEC)# or you must use 
the al ternate.user parameter to specify a NOS catalog 
containing the files (e.g. DEVI). 

AVMUTIL CLMDP DHHDISA ICMCLOS ICMFAI ICMFAPC ICMFLSH ICMGET 

ICMOPEN ICMPUT ICMWEOP IFMEXEC IIMA72H IIMDC2S IIMRLE 
IIMRSE IIMRUM IIMRUSM IIMTDEL OCMADD 0CM8IM OCM8IM OCMCOL 

OCMCQM OCMCPY OCMCRM OCMDEF OCMDEL OCMDLB OCMDNL 
OCMDOL OCMEND OCMGEN OCMLCH GCMLMG OCMLP OCMMUR 
3CMNP OCMGBJ OCMOFH OCMOMS OCMRCH GCMRED OCMREP OCMRMB 

OCMSAT OCMSOL OCMVEL OCMVLU OCMVOL PFMDC PFMTALL 
PUMBCAT PUMBCYC PUMBFIL PUMBFO PUHBLST PUM8PF PUMBSET 
PUMCOMN PUMCRAK PUMPURG PUMCRAK PUMIOBF PUMLIST PUMMISC 
PUMPURG PUMRALL PUMRCAT PUMREC PUMREF PUMRFIL PUMRPF 
PUMSTUB RHMLML RHMQAT RHMQOP RHMQRE RHMSFM USORT UTMDUR 

UTMPC1 UTMPC2 UTMPC3 UTMPC4 UTMPC5 UTMTSA UUSER1 



4.5.2 EXAMPLE OF NOS/VE INSTALLATION DEADSTART 

Type 

K#2. where 2 Is the TAFNVE control point number. 

K.5ETLA tyour_un#NVE) your_password 

K.GETF DS U-scat 

K.DS INSTALL GSL«N0 GP»NO AU»scat 

4.5.3 EXAMPLE OF NOS/VE "NORMAL" DEADSTART 

The Integration system has had the installation deadstart 
run on It. Also the files produced by the installation 
deadstart have been made semi-private and are found on the 
catalog used in the NVExxxx call* 

Cycle 3* May 1982 



4-10 
NOS/VE Cycle 3 Helpful Hints 

05/24/82 

4.0 DUAL STATS DEADSTART AnD OPERATION 

i 

Type twhere DEVI Is the same as the xxxx In the NVExxxx 
call)* 

K.2* where 2 Is the TAFNVE control point number. 

K.SETLA IDEV1.NVE) DEVIX 
K.GETF OS 
K.OS NORMAL 

4*5*4 EXAMPLE OF NOS/VE RECOVERY DEADSTART 

This Is the kind of deadstart that should most frequently 
be done In a "closed shop" environment and consequently Is the 
one for which all the parameter defaults are oriented* It 
presupposes that permanent file recovery has been successful* 

Type (where DEVI Is the same as the xxxx In the NVExxxx 
cat I) s 

K#2* where 2 Is the TAFNVS control point number* 

K.SETLA CDEVl.NVE) DEVIX 
<*GETF OS 
K*0S 



4*5.5 EXAMPLE OF MINIMAL NOS/VE OEADSTART 

The minimal deadstart shown below may be useful to OS 
developers who need to get the system up quickly and do not 
need the product set or all validated users* 

Type 

K#2* where 2 is the TAFNVE control point number* 

<*SETLA <your_un»NV£) your_password 

K.GETF OS U*scat 

K*0S NORMAL GSL-NO GP-NO QV-your.un AU»scat 

4.5.6 USE OF THE QUICK_DEADSTART COMMAND 

This command is intended as a development tool to 
facilitate •fast* deadstarts where recovery Is not needed* 

Indeed* if this command Is entered L&&Q.Z&LZ *iii_Qfli_£l£ 

£££l0.£I£i3 when the system is brought down for whatever 
reason* Specifying this command will cause an Installation 
deadstart to take place* If the INITDD command Is not 
specified then a default value of •VSNOOl 1 is used for the 
system deadstart device* Use of INITDD will allow setting the 
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deadstart devices Identifier to any value. THIS COMMAND WILL 
NOT BE ACCEPTED FROM A OEADSTART COMMAND FILE. 

Format* QUICKDS or QUICK.DEADSTART 

Valuest The default is false. Executing this command 
causes this initial value to be toggled* thus executing this 
command twice will cause the final value to be false* 

Notei QUICK_TEMPLATE«.LOAD does not exist now. 

4.6 nflSZ)ffi.JJII£&A£II)t£.£ACILIIX-Q££&AllflM 



4.6.1 OPERATOR INITIATION 

To bring up the NOS/VE interactive facility do the 
f of lowi ngt 

1) Bring up NOS/VE. 

2) Bring up NAM 

At the system console enter: 

3.NAMS2. for S2 
3.NAMS3. for S3 

3) If IAF is not up at control point \» enter! 
IAF. 

4) Bring up A170 part of interactive! 

TAFNVE. 

Control point two must be free or rolloutable (I.e. NAM 
should not be there). This also brings up PASSON* the 
Operator Facility* and the MLI subsystem control points. 

4.6.2 OPERATOR TERMINATION 

To terminate NOS/VE interactive any of the following may be 
done! 

— 3.CFO.0I#AP«TAF. (3 is the NAM control point number) 
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This Is the preferred method. To bring NOS/VE Interactive 
back up# you must first do a 3.CF0.EN* AP»TAF . 

3.CF0«DI#NE. (3 Is the NAM control point number) 

This terminates the entire network including IAF#RBF* etc. 

4.6,3 OTHER OPERATOR CAPABILITIES 

— To logically turn the printer on# under DSD enter? 

0N33. 
F0RM33>TM. 

To send a "shutdown warning" to ail terminals logged on to 
TAF do* 

3.CF0.ID* AP*TAF. (3 Is the NAM control point number) 

- To send a message to all terminals do: 

3.CF0.MSG# ALL>message* (3 is the NAM control point 
number) 

-■■ PASSON has the ability to record various types of 
diagnostic information. This capability is controlled via 
the sense switches at the PASSON control point. To turn a 
sense switch on (off) at control point N do* 

N.ONSWX. (N.QFFSWX.) 

Where X is the desired sense switch (1 to 6). The PASSON 
default is all sense switches off. It will take a short 
period of time before PASSON detects a change in a sense 
switch and reacts to it. The sense switches currently used 
by PASSON are* 

1 Network Trace 

2 PASSON Logic Trace To Dayflle 

3 Memory Link Trace To Dayflle 
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With the release of the Operator Facility Phase 1 several 
changes to the NOS/VE Operating System Milt occur that will 
effect the users of the NOS/VE Operators Console. The 
Operator Facility runs as part of the TAFNVE control point* 
This control point will wait for NOS/VE to become active 
U *e* the job monitor is initialized in the system job and 
SCL Is ready to ask for a command* When the request for K 
display appears on the NOS 8 Display* assign the K Display to 
the Operator Faci I i t y/TAFNVE Control point* All commands must 
be entered from this control point and not from the NVE 
Subsystem control point* The Operator Facility is capable of 
displaying both a left and a right screen area at the same 
time* If the operator wants both screens then type in KK « 
The contents of these displays are determined by the commands 
entered by the operator* 

The left screen is divided into four different areas* The 
top most area is the system header which contains the current 
date and time* memory statistics* and an operator action 
message if one is posted* The operator action will include 
the job sequence number of the owner of the message and 
•message cancelled 1 if the message is cancelled because the 
task has terminated* The next line contains the first 64 
characters of the operator action message (60 characters in 
stand alone)* 

The next area of the screen is the main output area* This 
area has the file name of OUTPUT* Any display command can 
have its output directed to this area as well as any system 
command* 

The third area is towards the bottom of the screen. This 
area is two lines long and contains the response area* This 
will contain error messages from system commands* The area is 
cleared when the next operator typein is entered at the 
operator's console and received by NOS/VE. 

The fourth area is the prompt area* This will contain the 
status of the keyboard. If NOS/VE is processing a command* 
then the keyboard is locked and all typeins will be ignored* 
When the keyboard is locked* the message *data received by 180 
- keyboard locked 1 will appear at the screen's bottom* When 
the keyboard is unlocked then any data in the keyboard buffer 
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will be sent to NOS/VE* The bottom line Is the last line that 
was processed by Operator Facility* 

The right K Display has the file name OUTPUT.RIGHT. There 
Is only one area on the right screen therefore the main 
display area Is 10 lines longer than the left screen area. If 
a dayf I le display or CP display is shown on the right screen 
you will get wore lines of information than on the left 
s creen* 



There are no default displays that come up automatically on 
either output display area. It is up to the operator to 
decide the display the operator wishes to see* The only parts 
of the display that come up automatically is the system header 
display and the prompt area for keyboard status. 



The Page width of the screen is 60 characters for 

standalone and 64 characters for dual state. The character 

set translation code is the same as that for the current NVE 

Subsystem control point* The escape code sequence for the 
special characters to be typed has not changed* There are a 

few differences in the processing of data by the Operator 
Facility and NVE Subsystem. 

1) Do NOT end commands with a period* Periods are sent to 
N3S/VE* 

Z\ The NVE subsystem commands that begin with an asterisk will 
not be supported from the Operator Facility control point. 
If these commands are entered from the Operator facility 
they will be passed on to SCL where an illegal command will 
be Issued* 

3) Routing of console job data to a specific job by the 
*n*command f protocol will not be supported in dual state* 
This feature should work in standalone but will not be 
supported* 

4) No type ahead - commands cannot be entered until the Prompt 
area shows that they are requested* 



There is one new command to replace the current display 
commands* The entry points for Zdls* Zdtsb* and Sdis have 
been deleted* The new command is VEDISPLAY and has two 
parameters. The options are listed below. The values in 
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parenthesis are the abbreviations. Note that this command 

does not begin with an asterisk (*). This command Hill be 

processed by SCL and create a new system control point task to 

display It's data* The user can have the same display type on 
each of the display areas* if the user so desires* 

Command Name Display Type Screen Area 



Parameter Name Parameter Name 

DISPLAYJ1PTI0NS OUTPUT (0) 

DISPLAY_0PTI0N (DO) 



Parameter Values Parameter Values 

VEDISPLAY (VED) DISPLA Y_SYSTEH_L0G OUTPUT 

J0BJ.0G UL) OUTPUTJUGHT <0R) 

C0NTR0L_P0INT CCPI 

The default file name for all displays is OUTPUT* 

The following Is a brief list of commands to bring up NOSVE 
with the Operator Facility installed* 

TAFNVE. to bring up iU/ICN/OF. RH and Interactive* 

n.NVEffff* to bring up NOS/VE. (See Section 5) 

K>2. 2 « control point for TAFNVE. 

KK* to bring up the K display on both screens* 

K.VED JL to bring up the job log* 

or 

K.VED DISPLAY_aPTIONS*JL OUTPUT-OUTPUT 

to bring up the job log using key word 

Identifiers* 

K.VED CP OUTPUT.RIGHT 

to bring up the control point display on 

the right screen* 
or 
K.VED DISPLAYJ3PTiaN$«C0NTRQL_PQINT 0UTPUT»0UTPUT_ RIGHT 

to bring up the control point display using 

key word 
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identifiers 
K*xxx send any command to NOS/VE* 



K.n* to set the K display to the NVE control 

poi nt* 

K*TERMINATE_SYSTEM_JOB to terminate NOS/VE, 

Note* After the OS procedure has completed execution the 
command to enter to bring down the system is 

TERHINATE_SY$TEM_JG3, not TERH INATE.SYSTEM. 



4.7*1 DELETE_J08_QUEUE \ DELETE_JOB_QUEUES S DELJQ (NEy) 

The purpose of this command is to delete all files from the 
Job Input subcatalog? the print subcatalog or both. This 
command is only allowed from jobs with operator and or system 
?r i vi leges* 

delete. job.queue Cqueue_narae» i nput ! outputs a I I 3 

Cstatus*<status variable>3 

queue_name S qn* This parameter specifies from which 
subcatalogs files are to be deleted. Specifying 
INPUT will cause all files to be deleted from the 
job swap subcatalog and the job input subcatalog* 
Specifying OUTPUT will cause all files to be deleted 
from the job output subcatalog* Omission will cause 
all to be used. 

statust See ERROR HANDLING. 
4.7.2 REBUILO.INPUT.QUEUE 1 RE8IQ (NEW) 



The purpose of this command Is to rebuild an entry in the 
Known Job List (KJL) from information In the System Label of 
the file representing the job being processed* This command 
Is to be used during the process of recovering the input 
queues during recovery deadstart* 

rebul ld_lnput_queue Cname«<name>1 

Cstatus«<status variable>3 
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4.7.2 REBUILD_INPuT_QUEU£ ? REBIQ <NEW) 

name ' n* This parameter specifies the file name of the 
file representing the job. An attempt is made to 
process the specified file within the catalog where 
job input queues are known to reside. 

status* See ERROR HANDLING. 

4.7.3 RE8UILDJDUTPUT_CUEUE \ RSBOQ (NEW) 

The purpose of this command is to rebuild an entry In the 
Known Output List (KOL) from information retained in the 
System Label of the file representing the output being 
Processed. This command is to be used during the process of 
recovering the output queues during a recovery deadstart. 

r ebul 1 d_ out put_ queue Cname«<name>l 

Cstatus«<status variable>3 

name* This parameter specifies the file name of the file 
representing the output* An attempt is made to 
process the specified file within the catalog path 
of where job output queues are known to reside. 

status* See ERROR HANDLING. 

4 . e aLQUi£.iii.iti£yi.£iL£.£EQa^i2a.ia-£isa 

Through the system console* enters 

Type 

X.DIS. 

USER, A, 8. 

GET* f i I ename. 

tfhere filename identifies the input file to be routed* 

R0UTE#f I !ename#DC«LP.FC*RH. 

4.9 &«QIS£JLAX.AaCII 

Support of 6-12 ASCII from the console (K display) causes 
the following changes! 

i&£iil IEA!iSLAI£l}-ia 1MUI IMUSUI£&-IQ 
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IX 

n » 

/3 # 

/4 $ 

15 (reversed / ) 

lb 1 

17 ? 

/8 t 

19 > 

10 . (underscore) 



/( 




c 


/) 




3 


/ + 




> 


/- 




< 


/« 




• 


/* 




i 


II 




/ 


If 




s 


Ik to 


/Z 


a 



(s ingle quote) 



a - z ( I ower case) 



*.io asai_ia£QaMiiaM 



To create an Express Deadstart Dump (EDO) tapes 

1) Hount scratch tape (ring in) on a 9-track drive. 

2) Push 0/S button. 

3) Select U (utilities) display. 

4) Select E (EOD) display. 

5) Set channel (S2»13). 
5) Set ECUU (S2«Gluu) 

E « equipment 

C * 1 for 67X drives 
2 for 66 X drives 

uu « unit number of the tape drive to be used. 

7) Answer w non zero inhibits rewind" with a CR. 

8) Answer "dump number" with a CR. 

9) Answer "dump control ware" with a CR. 

* - Warning if this step is omitted* DSDI canot 
process the dump tape. 

To create a listing of the EDO tape* 

1) REQUEST#DUMP#NT,D«PE#F»S>L8*KU#PO»R,VSN»your choice. 
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2) 6ET#0SDI/UN»DEV1. (On S/N 101.) 

or 
GET#DSDI/UN»D£V1. (On S2. ) 

3) Create DSOI directives file* 

A 0S0I directive file should Include the following! 

IOUMR. 

PRGMR. 

MEMMR. 

PRORF. 

Wt f irst.byte.address, I ast_byte_adress# as! d. (where 

the f I rst_byte_addr ess and 1 ast_by te^address are hex 

byte addresses and asid is the asid of the segment to 

be dumped) 

4) Execute DSDI* 

R Ft #60000. 

DSDI»H*D* I» w |nput directives file**. 

5) To run (after the first time)* 
DSDI#I«n. 

(Does not read tape again.) 

6) To run interactively: 

Same as above* except to do W command must first do* 
OUTPUT, LISTFIL. 

7) C170 0SDI information can be found in Chapter 10 of 
the N0S SYSTEM MAINTENANCE Manual. 

A170 DSDI info can be found In document ARH3060 — GID 
for A170 N0S/S2. 

4.ii aami-mamiifla 

o Bringing down dual state: 
2.0FFSW6. 
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K*n - n is the NVEffff control point 

K.TERHINATE_SYSTEM_JOB 

o If not a normal termination 

K* n - n is the NVEffff control point 

K.*RUN. 

K.*ENDIST. 

K.*ENDRUN. 

*.i2 uzfljias-sauiflQMii 

Before leaving the machine* it is necessary to bring NOS 

down. If NOS has crashed* a level 3 deadstart must be 

attempted even If the only reason Is to bring NOS down. To do 
a level 3 deadstart* 

1) Push D/S button 

2) Select m Q« display 

3) Select "P" display 

4) Enter I «3 

5) Enter (CR) 

6) Enter date/time 

If a dump is desired but a crash has not occurred STEP. 
should always be entered before pushing the deadstart button* 
After the dump has been taken a level 3 deadstart should be 
performed. 

To bring NOS down* do the following' 

1) Enten 

CHE 

The screen will displays 
CHECKPOINT SYSTEM. 
Enter' carriage return 

2) flake sure no mass storage device has a checkpoint 
rguested. To do this* enter' E*N* If the display shows 
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there are no "C"s in the status field* then al'l devices 
are checkpolnted and you ?nay continue* 

3) Enters 
STEP* 

4) Push deadstart button. 
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5.1 1EIIE-EQ&MI 



The general format of the SETVE command is 

X.SETV£{PN*ffff#UN»un* VSN*vsn#D»d#P»p,8«b>C*c,CH»ch) 

ffff Is a string of no more than four characters. SETVE 
appends ffff to »NVE* to construct the name of a 
procedure file which* when invoked* will deadstart 
NOS/VE. The default is TST. 

un specifies the user number from which TPXXXK is 
attached* Un is the first catalog searched for 
other files used in deadstartlng and terminating 
NOS/VE. The default is INT1. 

c specifies the deadstart command deck to be used when 

deadstartlng NOS/VE. The function served by the 
deadstart command deck is analogous to the function 
served by the CNRDECK of NOS . Currently supported 
values for c and their respective uses are* 

1 Arden Hills S3 

6 Arden Hills S2 open shop/hands on 

7 Arden Hills S2 closed shop 
10 Sunnyvale S2 closed shop 

The default is set In the file CMDS1. Currently 
the default is 6. 

b specifies an alternate catalog to be searched for 

the various files used In deadstartlng and 
terminating NOS/VE. The default is INT1. 

d Is used to indicate that the system core command 

processor should accept commands from the console. 
Specifying D«T in the SETVE command allows the 
operator to enter commands from the console after 
processing the deadstart command deck. If the 
operator wishes to initialize the system device 
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and/or Install a new version of NOS/VE* 0«T must be 
specified. The default is set in the file CMDS1. 
Currently the default is D»F. 

P specifies the password for the catalog Indicated by 

the un parameter. If this parameter is omitted the 

password will be generated by appending an f X* to 
the UN parameter. 

ch specifies the octal channel to be used for NOS/VE 
disk I/O. The default is set in the file CMDS1* 
Currently the default is 2. 

vsn specifies the vsn of a deadstart tape. If this 
parameter is used then NOS/VE will be deadstarted 
from the tape specified. If it is omitted* then 
NOS/VE will be deadstarted from the permanent file 
TPXXXK. 

Earlier versions of NOS/VE required that two SETVE commands 
be issued If the system was to be installed and subsequently 
recovered. The current system does not require this. The 
only reason for issuing two SETVE commands Is to provide a 
deadstart procedure that does not require/permit operator 
i nter ventlon* 

It should be noted that once the SETVE command has been 
issued* it need not be issued again unless*. • 

1) There is a need to change one or more of the parameters 
specified in SETVE. 

Z) The command file* NVEffff* generated by the SETVE 
command is purged from the system. 

Two examples of SETVE usage and subsequent NOS/VE deadstart 
are given below. The first example shows a "hands on" user 
working with recovery. The second illustrates these concepts 
for a typical NOS/VE closed shoo* This writer hopes that the 
reader will find both examples useful and illuminating* 

I* A "hands on" user 

The command file NVERSO is built and Installed in NOS 
by typing 
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5.0 RECOVERY OF NOS/VE PERflANENT FILES 

X.SETVE(R$D#UN»RS0,VSN*TA!>E,B»DEV1,C»6,D«T) 

Several of the choices of parameters nr e worth 
noting* 

1) By specifying the VSN parameter the user has built 
a command file that will deadstart the system 
directly from the tape produced by NVESYS. 

2) The user in this example has specified deadstart 
command deck 6 CC parameter) and has allowed the 
NOS/VE disk I/O channel <ch parameter) to default 
to 2* One concludes that the user is running on 
the Arden Hi I Is $2. 

3) The user has specified D*T. This is important. 
The deadstart command which triggers installation 
of a recoverable system cannot be read from a 
deadstart command deck. It must be entered from 
the console at deadstart time. Specifying 0»T 
allows the operator to enter commands from the 
conso le. 

NOS/VE is deadstarted by typing 

n.NVERSD. 

at the console, (n is a control point which is NOT 1* 2 
or ordinarily occupied by HAGNET, BATCHIG, or SYSTEM) 
The user brings up TAF* PA$$0N> and IRHF by typing 

TAFNVE. 

The user brings up the K display by typing 

K,n. 

(where n is the NVE control point.) 

Presently* the deadstart command deck is displayed 
and the user is prompted for input. The deadstart 
command deck used in this example looks like thisi 

USECP S2CFIG 

USEIP EMPTY 

SETDCT $7155.1 

SETOD $885.12 32 

The user types 
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K.INITDD VSN001. 
K.GO. 

The system accepts the commands and installs and 
deadstarts NOS/VE. 

After the system comes down* via either controlled 
termination or a crash* the system can be recovered (If 
necessary) and redeadstar ted by typing 

n.NVERSD. (where n is an appropriate control point.) 

When the deadstart command deck is displayed* the 
user types 

60* 

This will cause NOS/VE to be deadstarted without 
initializing the system device. 

II. A typical "closed shop" 

Two command files* NVECLSH and NVEINST* are created 
by typing 

X.SETV£CCLSH*UN*CLSH*B»DEV1*C«10*CH»1) 
X.SETVE<INST*UN«CLSH*B*DEV1*C*1C*CH«1*D«T) 

One notes that 

1) Closed shop is deadstarted from a TPXXXK file in 
the CLSH catalog. 

2) the only difference between the command files is 
that NVEINST causes deadstart to pause for 
operator input and NVECLSH does not. It is 
intended that NVECLSH be used for normal 
deadstarts. NVEINST is to be used in cases 
requiring operator intervention. 

A normal deadstart is used when bringing up NOS/VE at 
the beginning of closed shop or following a system 
failure. The operator* in this example* types 

n. NVECLSH. 

NOS/VE will recover (if necessary) and deadstart. No 
operator intervention is required. 
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If it Is necessary to reinitialize the system device* 
or If the Installation is upgrading to a new version of 
NOS/vE* the operator keys 

n.NVEINST. 

This causes deadstart to pause and wait for operator 
Input when deadstart commands are being processed. 
There are two cases requiring discussion here. The 
first is the case of upgrading to a new and compatible 
version of NOS/VE. The second case is used only when it 
is necessary to reinitialize the system device* 

The first case Involves the installation of a new 
version of NOS/VE. In order to install a new version of 
the system* the old system must have been idled in an 
orderly way* A new system cannot be installed if* 
following a crash* the system being superceded was not 
recovered* Assuming everything in the old system is 
tidy* and the file systems are compatible* the operator 
keys 

K.SETSA IN$TAlL_jaB_TE*PLATES 1. 

K.GO. 

when the system displays the deadstart command deck and 

prompts for input. The new system is installed* the 

file system is preserved* and deadstart proceeds. 

The second case amounts to an installation 
deadstart. This should be used only with full knowledge 
that any files which may have existed on mass storage 
prior to this deadstart* &lLL„h& m hl m \ m ,£&&„Ln£2„&h±ixiQn 

An installation deadstart will be required If 

1) This is the Initial Installation of a recoverable 
version of NOS/VE. 

2) If the file systems of the system being installed 
and the system being superceded are not 
compati bl e, 

3) If the file system has been damaged beyond the 
possibility of recovery. 

An installation deadstart is effected by typing 

K.INITDO VSN001. 
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5*0 RECOVERY OF NOS/VE PERMANENT FILES 
5.2 SETVE USAGE 



K*G0. 

when the deadstart command deck Is displayed and the 
operator is prompted for Input. 

NOTESi 

1. The CH0S1 file used to deadstart NOS/VE must have 
the 0E8UG2 flag set to TRUE. When NQS/VE is 
deadstartedt the catalog specified by the UN 
Parameter is first in the search order for CMDSl* 
followed by the catalog specified by the B 
par ameter • 

2. See Section 3.3 of the Integration Procedures 
Notebook for other Information about the CMDS1 
fil e. 

3. If NOS/VE crashes and a dump is desired C in the 
context of our second example) 

i. Type du at the MOD console* The message 
"WRITING IMAGE FILE" should appear 

immediately. The message "IMAGE FILE 

COMPLETE" should appear a few moments 
I ater. 

ii. Pusfc the deadstart button. 

Hi* Take the EDO dump. 

iv. Do a level 3 NOS deadstart. 

Alternatively the operator can skip step I If 
she/he is sure to redeadstart NOS/VE after step 
iv. In this event the system wilt detect that the 
image file was never created* will create one. and 
wl I I recover from J t. 
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6.0 miM-£0SI-fi££U£i2£E 



The System Core debugger provides a set of capabilities 
intended to assist in debugging the operating system* 
Services provided by the debugger are task oriented* selection 
of the tasks to be debugged must be made via debugger 
subcommands* No tasks will be under control of the debugger 
unless they are selected. The selection capability allows any 
number of tasks to be debugged simultaneously; from one task 
to all tasks in the system. Obviously a capability this 
powerful must be used with some care. The System Core 
debugger uses the debug hardware to provide these 
capabi I i ties. 

6.1 iXIQElUS 

The purpose of this command is to initiate execution of the 
system core debugger. This command can be issued from the 
deadstart command file or as a command in any Job. 

sysdebug 

This command has no parameters; all information the 
debugger requires is provided via subcommands. 

The system core debugger can also be invoked from the MOD 
console. The format of the command is* 

00 n. sysdebug 

where n Is the job ordinal of the desired job. The debugger 
is brought UP In the job monitor task of the job. All system 
core debugger subcommands are available* but must be prefixed 
by the HDD command DO* 

6.2 5UflCQaUAHfi-£AaAll£I££.a£EIllIIIQtl5 

<name> **« 1-8 character breakpoint name 
<condltion> it* READ J WRITEJRNI! BRANCH JCACL5 DIVFLT! ARIOS! 

AROVFU EXOVFLJ EXUNFUFPIQS J FPINDEF MNVBDP 
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6*0 SYSTEM CORE DEBUGGER 

6,2 SUBCOMMAND PARAMETER DEFINITIONS 



<base> *** process virtual address 

<offset> tt» integer 

<length> *t* integer 

<frame> tt« 1**100 

<count> *** 1*. 10000 

<regid> **« xJASP 

<regno> tt« 0*. 1510* *0F<16) 

<value> *t» integer 

<ti»e> n« 1*.<2**31)-1 

<vstrJng> *»• 'charstring* 

<datatype> n* HEX! ASCII J ASC J DEC 

<change_eount> *«« 1**8 

<selector> J*« FULL! AUTO! SAVE 



6.3 mi£a.£QB£-IOU£££R-il2Mai3MMaS 



Within the descriptions which follow* optional parameters 
are enclosed In brackets. Default values for optional 
parameters are also defined* 



6,3.1 SELECT 



The purpose of this subcommand is to select the tasks in 
which the system core debugger is to be active* When the 
debugger Is first called* it is not active in any task* To 
use the debugger therefore* it Is necessary to select the 
tasks in which it is to be active* 

select <selection option> Kring number> ! <active job list 
ord|nal>3 

sel ectlon.optioni This parameter specifies one of a 
series of selection options used to control the 
tasks in which the debugger will be active and some 
other debug options* The selections are remain in 
effect until they are explicitly changed with 
subsequent SELECT subcommands* Valid selection 
options aret 

<right*left> - This selects the screen for the debug 
display* The display stays active when the screen 
Is switched* 

< jobmoni tor Snojobmoni tor> - This selects whether or 
not to debug job monitor tasks* 
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<user Snouser> - This selects whether or not to debug 
user tasks (i.e. those that are not job 
moni tors) • 

<highrin9> - This specifies the highest ring in 

which debug traps will be recognized* Traps 

occurring in rings above this selection will be 
ignored. 

<joblnojob> - This enables or disables debugging for 
the job at the specified active job list 
ordinal* The system job has an active job list 
ordinal of zero. 

<al I jobslno jobs> - This activates or deactivates 
debugging in ai I jobs. 

The initial selections are* RIGHT* NOSTEP* 
NOjOBHONlTGR, NOUSER, HIGHRING«3* NOJQBS. 

6.3*2 BREAKPOINT I B 

The purpose of this subcommand is to selects a program 
interrupt which is to occ specified condition within a 
specified virtual address range. 

breakpoint <name> <condition> C<base>1 t<offset>3 C<iength>3 

The <name> is any user supplied name for identifying the 
breakpoint* A maximum of thirty two breakpoints can be 
selected* When a trap occurs* the <name> of the breakpoint 
which caused the trap is displayed* 

The base Parameter is required when specifying a new 
breakpoint name! offset and length specifications are optional 
in this case* When adding a new condition selection to an 
existing breakpoint* base* offset? and length parameters may 
not be speci fled* 

Base* offset* and length parameters define the desired 

virtual address rangei <base> + <offset> yields a 

first-byte-address; first-byte-address ♦ <length> -1 yields a 
last byte address* 

Default parameter values* 

<offset>* 
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6.3.2 BREAKPOINT J B 



<length>i 1 



6.3.3 REHOVE. BREAKPOINT ! RB 



The purpose of this subcommand Is to deselect a previously 
selected program Inte 

ramove.br eakpoi nt <name> £<cond i t io n>3 

If only the name parameter Is specified* all conditions 
associated with the breakpoint are deselected and all evidence 
of the breakpoint is removed. If the condition parameter is 
specified* only that condition Is deselected; however* if the 
specified condition Is the only condition selected* all 
evidence of the named breakpoint is removed. 



6,3.4 LIST.BREAKPOINT J IB 



The purpose of this subcommand Is to provide a list of 
currently selected breakp and associated conditions. 

I I st.breakpoint C<name>3 

If the name parameter is specified* information is 
displayed for the named breakpoint only. If the name 
parameter Is not specified* information Is displayed for all 
currently defined breakpoints. 



6.3.5 CHANGE.BREAKPOINT I CB 



The purpose of this subcommand Is to change the virtual 
address range of a previ specified breakpoint. 

change.br eakpoi nt <name> <base> £<offset>3 £<length>3 

Base* offset* and length parameters define the desired 

virtual address range* <base> + <offset> yields a 

f Irst-by te-addressj f I rst-byte-address + <length> -1 yields a 
last byte address. 

Default parameter values' 

<offset>* 
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6.0 SYSTEM CORE DEBUGGER 
6.3.5 CHAN5E.8REAKPQINT J CB 



<length>* 1 
6.3.6 TRACE_BACK J TB 



The purpose of this subcommand Is to provide information 
relevant to stack frame associated with an interrupted 
procedure and its predecessor procedures* Validation of PVA's 
is now performed* 

Information displayed for each selected stack frame 
consists oft 

— Stack frame number ? 

— Current P-address of the associated procedure; 
Virtual address of the start of the stack frame; 

— Virtual address of the stack frame save area, 

trace_back C<frame>3 C<count>3 CFULLJSHQRT3 

The frame parameter specifies the number of the first stack 
frame for which information is to be displayed* Stack frame 
number one is associated with the interrupted procedure* stack 
frame two is associated with the interrupted procedure f s 
predecessor* etc* 

The module name provided on the traceback is usually 
correct but not guaranteed* 

The count parameter specifies the total number of stack 
frames for which information is to be displayed* 

Default parameter values: 

<frame>i \ 
<count>i 1 



6.3.7 DISPLAY_STACK_FRAME I DSF 



The purpose of this subcommand is to display selected 
information from a specifi stack frame* 

dlspl ay_stack_f r ame [<frame>l E<selector>3 

The frame parameter specifies the number of the stack frame 
for which information is to be displayed* (Stack frame number 
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one Is associated with the Interrupted procedure* stack frame 
two Is associated with the interrupted procedure*s 
predecessor* etc*) 

The selector parameter Identifies a region of the specified 
stack frame* 

AUTQt Causes the automatic region of the stack frame to be 
dl splayed* 

SAVE! Causes the save area of the stack frame to be 
displayed. 

FULL* Causes both the automatic and save areas of the stack 
frame to be displayed. 

Default parameter values! 

<frame>i 1 
<selector>t FULL 

6.3.8 DISPLAY.REGISTER J DR 

The purpose of this subcommand Is to display the contents 
af a specified registe Interrupted procedure. 

di spl ay. register <regld> C<regno>l t<datatype>l 

Default parameter values! 

<regno>! 
<datatype>! HEX 

6.3.9 0ISPUY_M6M0RY ! DM 

The purpose of this subcommand is to display the contents 
of a specified area of virtual memory. Validation of PVA's Is 
now performed. 

displ ay. memory <base> C<length>3 

Default parameter values! 

<iength>! 8 
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6.3.10 CHANGE_N£MGRY J CM 

The purpose of this subcommand Is to set a specified value 
Into a specified loca of virtual memory for a specified number 
of bytes* Validation of PVA f s is no* performed, 

change.memory <base> <vaiue> <cbange_count> 

Default parameter values* 

<change_count>* 1 

6.3.11 RUN 

The purpose of this subcommand is to invoke program 
execution after a selected p Interrupt has occurred. 

run 

6.3.12 SUi»ER_CHANGE_MEMORY ! SCM 

The purpose of this subcommand is the same as the change 
memory subcommand* that is# to change the contents of virtual 
memory* It differs from change memory* however* in that it 
wilt change the attributes of the segment to allow memory to 
be mr Ittent and then change the attributes back to their 
original values. 

The command format Is the same as the change memory 
subcommand. 
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7 a umaaumrm 



Tasks running in job mode Mill occasionally cause an error 
which Is detected either by the hardware or NOS/VE monitor* 
The action taken when an error like this occurs Is controlled 
by various system attributes* The purpose of this section is 
to discuss the types of errors and the effect a given syste* 
attribute will have upon the handling of the error* 



7.2 IX££S_!2£.£££Q£S 



II BROKEN TASK* A broken task is a task in which the trap 
mechanism is not able to function correctly* NOS/VE 
monitor will attempt to repair the trap mechanism and send 
a broken task fault to the task* The specific cases of a 
broken task are* 

system error job mode software has 

declared the task to be 
broken* (This is a special 
case of broken task*) 

monitor fault buffer full job mode errors are 

occur! ng but are not being 
processed by job mode* 

traps disabled a job mode error has 

occurred while traps were 
disabled* 

invalid A0 the task's A0 register was 

inva lid* 

UCR/MCR traps disabled UCR/HCR error occurred with 

traps di sabl ed* 

2) HCR FAULT* This error signifies that job mode caused a 
hardware detected HCR fault* This may be caused by 
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software or hardware detected uncorrectable error* 

3) UNKNOWN SYSTEM REQUEST! This error signifies that job mode 
issued a monitor request that Is either invalid or cannot 
be issued from the ring it was issued from* 

*) SEGMENT ACCESS FAULTS* These errors signify that job mode 
encountered or caused one of the following errors* 

- page fault for an address greater than £01 on a 
read-only file (segment) 

disk read error 

These errors either originate in NOS/VE monitor or cause 
the hardware to exchange to monitor* Depending on the values 
of certain system attributes* monitor will halt or reflect the 
error back to job mode as a monitor default. 

It Is at this point that the system core debugger can be 
activated, CSee the definition of S YSTEM_DEBUG_RING in the 
next section*) 

The normal job mode OS actions for these faults are* 

broken task exit 

MCR fault cause condition 

Invalid system request exit 

segment access cause condition 

7 . 3 SXSIfa.AII&lflUI£S-£JDB-EBBDS.£&fli:£5 ttitfi 

The following system attributes can be set or displayed by 
the SETSA and DISSA commands, 

7,3.1 HALTRING 

If a broken task or MCR fault occurs at or below the value 
of HALTRING CP register ring number)* NOS/VE monitor will halt 
the system. Broken tasks occurring above HALTRING will cause 
a monitor fault to be sent back to job mode. 
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7.3.2 SYST£fl_£RROR_HANG_COUNT 

This Is the number of broken task errors allowed to occur 
In any given task before that task is considered a hung task* 

7.3.3 HALT_QN_HUNG_TASK 

If this attribute is true* then an occurence of a hung task 
Milt cause N0S/V£ monitor to halt the system. If the 
attribute is false* the task * i II be sent a signal to *hang» 
itself* i.e. to go into an infinite wait doing nothing* Jobs 
with hung tasks will have a *H in the status field on the 
operator CP display. 

A hung task will also occur if any error happens in job 
mode ring 1. 

7«3.* SY$T£H_DEBUG_RING 

If an error (broken task* HCR fault. unknown system 
request* or segment access fault) occurs at or below the value 
of this attribute (P register ring number)* the system core 
debugger will be invoked within the task. At that point in 
time the task environment can be examined by using system core 
debugger commands. 

If the RUN command is issued to the debugger* the system 
will take its normal action for the specific fault. 
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8*0 STAND AiONE DEADSTART 



3.0 iIAtia.4LQ!i£«Qt£Ai5SIi£I 



Standalone deadstart does not work for Cycle 3# Code will 
be transmitted for Cycle 4 to repair this; this section will 
be rewr \ tten then* 
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9 . IMl££A^II^£-££Qi££I-.aU!lE-AtlALISIS-££Q££fiy E£S 



The following procedures were developed by the interactive 
project to assist them In Interpreting dumps* They guarantee 
the procedures work if your user name is IFPj otherwise caveat 
emptor* For more information about these procedures* contact 
Fred Bischke. 



The following dump analysis procedures are available in the 
IFP catalog: 



9.1 

EOOSIH 

This Is a CCL procedure which brings an SOD dump tape on a 
spec! fi ed 

VSN into the simulator. The procedure can be accessed from 
the IFP 

catalog as follows* 

get*eddsim/un*if p 

beg) n* *eddsim*vsn ( vsn is the vsn of the EDO dump tape ) 

9.2 

ANALEXC 



This is a Simulator INCLUDE file which does a preliminary 
analysis of 

the current simulator exchange package C when the systeir 
crashes in task 
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9*0 INTERACTIVE PROJECT DUHP ANALYSIS PROCEDURES 
9,2 



services* this will normally be JPS )* A qr exc»mon or qr 
exc*rma can be 

used to get into another exchange package before doing the 
include* 

The include file is ANALEXC /UN* IFP* It can be called from 
the simulator 

as follows' 

* get* analexc/un*i f p f J include analexc 



(carriage return) a lone carriage return must be entered 
after an INCLUDE 

in order to start it up 



9.3 



SEGDUHP 



This Is a CCL procedure which calls DSDIV to dump a 
specified segment to 
a list file which can then be examined with an editor or 
printed* 

The procedure can be accessed from within the Simulator as 

f Ol lOWSt 



•get*segdump/un«i fp» » ' begi n» *segdump* seg* I en*f i I e*exc*cpf • <* 

The segdump parameters are* 
seg - segment number in hex ( default is 1 ) 
length - number of bytes to dump In hex i default Is 1C0C0 ) 
list - name of the list file ( default is LIST ) 
exc - reference exchange package C default is JPS ) 
cpf - name of checkpoint file ( default Is CPF ) 
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9.3 



In most cases of task services debugging, only the seg 
parameter Is 

needed* 



9.4 



AN At J OB 



This Is a CCL procedure which uses OSDIV* XEDIT and the 
Simulator to 

perform an analysis of all tasks In a specified job. The 
procedure can 

be accessed from within the simulator as follows! 



'getf anal job/un*if p» J •begin* ? anal job»seg>cpf * 



The analjob parameters are* 

seg - the monitor segment which contains the exchange 
packages of the job ( 14 is the system job* 15 is job 1 etc* 
) ( default Is 14 ) 

cpf - tfoe name of the simulator fi le < default is CPF ) 



After the procedure has completed* a list of the RMA f s of 
the 

job , s exchange packages can be obtained by doing the 
following: 



Include tplist 



(carriage return) 



A traceback of all tasks in the job can be obtained by 
doing the 
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f ol I owing: 
include tbl I st 
( car r I age return) 
include tbrun 
(car r lage return) 
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What we have established in the lab so far is the following* 

A 600 tape capacity tape rack for general use. If your 
project would like to reserve a section of this tape rack* 
contact Tim McGlbbon or Bonnie Swierzbin 

- A tape and disk cabinet for storage of system support 
materials which this project will manage and keep up to 
date* (If you have been using this cabinet for 
unauthorized storage - beware. We have the key to the 
lock!) More will be published about the contents of this 
cabinet later* and a cabinet index will be posted in the 
lab to help locate where things are supposed to be placed 
within the cabinet. This cabinet is currently located in 
the southeast corner o* the lab* is 6 ft. 8 In. tall* 
gray In color and with sliding door. 

- A microfiche reader and a metal box containing the most 
recent microfiche of the system compilation listings end a 
link map* These items are kept on the table to the right 
of the console. 

- A desk documentation rack for reference manuals and Tom 
McGee's collection of "ho* to" goodies* The objective is 
to have this reference information at arm^s length of the 
console* but it is currently on top of the two-level unit 
by the West wa 1 1* 

- At or near the console is a small notebook containing the 
NOS System Programmers Instant* NOS Application 
Programmer's Instant* and the 180 Instruction codes* 

Feel free to examine and use all of the above materials while 
in the lab* 

Do not remove or abuse any of these materials* 
Please notify Tim HcGibbon or Bonnie Swierzbin of any 
problems or deficiencies of these materials. Leave a note if 
we are not available. 
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1*0 Hardware Overview 

1*1 An Introduction to CY8ER 180 

1*2 C180 Instant 

1,3 Model Independent General Design Specification - 
ARH1700 

2.0 NOS Reference Manuals 

2.1 XEDIT V3.C - 60455730 

2.2 IAF VI. User's Guide - 60455260 

2.3 NOS Reference Manual -Vol 1# 60435400 - Vol Z, 
60445300 

2.4 NOS Instant 

2.5 NOS Operators Guide - 60435600 

2.6 NOS Diagnostic Handbook 

2.7 NOS A170 ERS 

2.8 NOS A17C GID - ARH3060 

3.0 NOS/VE Reference Documents 

3.1 Program Interface ERS - ARH3610 - obtained from Karen 
Rubey (482-3966) or via SES.TOGLDQC 

3.2 Command Interface ERS - ARH3609 - obtained from Karen 
Rubey (482-3966) or via SES.T001DQC 



3.3 NOS/VE Procedures and Conventions - SES0010 - obtained 
by SES.TOOLDOC 

3.4 listing of all NOS/VE Modules - obtained by 
SES#DEV1.LISTNVE. See Integration Procedures Notebook 
for detai Is. 
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3.5 NQS/VE Internal Interface Maintenance Procedures 

Memo available from $•€• Wood* 

3.6 



Integration Procedures Notebook 
Obtained byi 
Acquire#IPNDOC/UN«DEVl. SES. PRINT* IPNDOC . 

4*0 Tools Reference Documents 

4.1 CYBIl Interactive Debugger - ARH3142 

4.2 SES User's Guide - ARH1833 

4.3 CYBIl Specification - ARH2298 

4.4 C180 Assembler ERS - ARH1693 

4.5 Simulator ERS - ARH1729 

4.6 VEGEN ERS - ARH2591 

4.7 VELINK ERS - ARH2816 

4.8 Simulated I/O ERS - ARH3125 

4.9 Object Code Utilities ERS - ARH2922 

4.10 CYBIl Implementation Dependent Handbook - ARH3078 

4.11 CYBER 180 INTERACTIVE DEBUG External Reference 
Specification and Users Guide - S4028 
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